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open 

set_scope 
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SECTION 1 



SELECTION LANGUAGE 



The Logical INquiry and lUpdate System (LINUS) is a powerful, yet "easy-to-use" 
facility for accessing centralized Multics Relational Data Store (MRBS) data 
bases. However, it is also possible for users to define private data bases and 
utilize LINUS to access and maintain them (refer to Section 3). LINUS provides 
a complete data base management capability including both retrieval and update 
operations. Data to be selected is specified via a selection language which is 
a high-level nonprocedural language capable of being understood and used by 
individuals who are not necessarily computer specialists. 



Several of the LINUS requests (e.g., modify, delete, and print) operate on 
well-defined subsets of a data base. These data base subsets are selected via 
query statements. The user views the data base as a set of tables containing 
rows and columns of data. LINUS allows the selection algorithm to be specified 
as a series of table lookup operations, very similar to the way an individual 
manually scans a set of tables for information. For example, envision a telephone 
directory as being a table with three columns of information: name, address, 
and phone number. This table contains one row of information for each individual 
listed in the directory. Normally, to find the phone number for John C. Smith, 
the name column is scanned for the name "Smith John C" , and the value is taken 
from the phone number column in the same row. In LINUS, this operation is 
described as: 

select number 

from phone_book 

where name = "Smith John C" 
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Various features of LINUS are introduced via examples referencing a data 
base consisting of the following five tables that describe the operation of a 
department store: 



emp 


name 


emp no 


dept 


mgr 


sal 


comm 















sales 


dept 


item 


vol 













supply 


supplier 


items 


vol 









loc 


dept 


floor 







class 


item 


type 







The emp table contains a row of information on every employee, giving employee 
name, employee number, department, manager's employee number, salary, and commission 
for the last year. The sales table gives the volume of sales for every item 
within each department. The supply table provides the volume of each item supplied 
by every supplier. The loc table gives the floor on which every department is 
located, and the class table specifies the type of each item. 



In each of the tables, the underscored words denote key columns. Every row 

in a table is uniquely identified by its values in the key columns. The LINUS 

user need not be concerned with the key column concept except when using the 
modify and define temp_table requests discussed later. 



The basic component of the selection language is the select-f rom-where block, 
which is used to select column values from one or more tables where rows of the 
tables satisfy certain conditions. It should be noted that the indention of the 
following examples is for readability only, and is not required in actual usage. 
In fact, the entire query may be contained in one line. 



The select clause and the from clause must always be specified in a 
select-f rom-where block. The where clause of a block may be omitted, in which 
case all rows are returned. 



Example 1 



List all departments from the emp table. 

select dept 
from emp 

This could alternately be written as: 
select dept from emp 
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A select clause may contain one or more column names, or may contain an 
asterisk (*) which indicates that all columns from qualifying rows are to be 
selected . 



Example 2 



List all information pertaining to every employee whose salary is greater 
than $8,000. 

select * 
from emp 

where sal > 8000 



More complex conditions may be specified in the where clause, as shown in 
the remaining examples in this section. Specifically, a where clause may contain 
one or more terras. Each term consists of a column name or an arithmetic expression; 
followed by a relational operator; followed by a column name, arithmetic expression, 
or constant. Allowable relational operators are: 

> greater than 

< less than 

<= less than or equal to (or not greater than) 

>= greater than or equal to (or not less than) 

= equal to 

not equal to 



Terms within the where clause must be separated by logical operators, and may be 
grouped using parentheses () to explicitly specify order of evaluation. Allowable 
logical operators are: 

& logical conjunction (and) 

I logical inclusive (or) 

logical negation (not) 



Character string constants within terms must be enclosed within quotes "". If a 
quote is to appear within a character string, a double quote must be specified. 



Example 3 



Find the names and salaries of employees in the toy department who work for 
Anderson, whose employee number is 1423. 

select name sal 
from emp 

where dept - "Toy" & mgr = 1423 



Example 4 



Arithmetic expression may be contained in both the select clause and the 
where clause. All columns used in any given arithmetic expression must be defined 
over the same domain. Allowable operators in an arithmetic expression are: 

+ addition 
- subtraction 
* multiplication 
/ division 
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Find the names of employees who are either in the Admin department or whose 
sum of salary and commission exceeds $10,000. 

select name 
from emp 

where dept = "Admin" | sal + comm > 10000 



It is possible to specify more complex table lookup operations by using a 
select-from-where block as the last component of a term in the where clause. 
This indicates that the comparison specified in the term is to be performed for 
every value selected by the inner block. All inner select-f rom-where blocks 
must be delimited by braces {}. 



Example 5 



Find all items sold by departments located on the second floor. 

select item 
from sales 

where dept = {select dept 
from loc 

where floor = 2} 



One can apply set functions to the results of a select-f rom-where block, as 
shown by the following examples. Allowable set functions are: min, max, count, 
avg, sum, and user-defined functions. User-defined functions are discussed in 
Section 2 (Writing Nonstandard Functions) and in Section 4 (Declare Request). 



Example 6 



Find the average salary of employees in the shoe department. 

avg {select sal 
from emp 

where dept = "Shoe"} 



Example 7 



Find all employees whose salary is greater than that of any employee in the 
shoe department. 

select name 
from emp 

where sal > max {select sal 
from emp 

where dept = "Shoe"} 



A select clause can also contain an arithmetic expression as shown in the 
following example. 
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Example 8 



Find each employee in the shoe department, together with her/his deviation 
from the average salary of that department. 

select name sal - avg {select sal 

from emp 

where dept = "Shoe"} 

from emp 

where dept = "Shoe" 



Set operations can be applied to the results of select-from-where blocks. 
In LILA the set operations are union, differ, and inter, which correspond to the 
union, difference, and intersection operations as normally defined. That is, 
the union of two sets consists of all items that belong to one or both of the 
sets. The intersection of two sets consists of those items belonging to both 
sets. The difference of two sets consists of those items which belong to the 
first set, but not to the second. For example, assume that set A contains the 
elements "a", "b", and "c" and the set B contains the elements "c", "d", and 
"e", then: 

A union B (and B union A) is abode (all items belong to one or both 

sets) 



3 




Ac 









Set A Set B 



A inter B (and B inter A) is c (items belong to both sets) 




Set A Set B 



A differ B is ab (items belong to the first, but not second set) 




Set A Set B 
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B differ A is de 



(items belong to the first, but not second set) 




Set A Set B 



Example 9 



Find those items which are supplied by Levi and sold in the men's department. 

select item 
from supply 

where supplier = "Levi" 
inter 

select item 

from sales 

where dept = "Men" 



Nesting of select- from-where blocks is possible in order to specify complex 
selection criteria. 



Example 10 



Find the total volume of type A items sold by departments on the second floor. 

sum {select vol 
from sales 

where item = {select item 
from class 
where type = "A"} & 
dept = {select dept 
from loc 

where floor = 2)} 



It is also acceptable to bypass the nested block notation and use table names to 
qualify column names (including *) within the select and where clauses. This 
qualification is accomplished by prefixing a column name with a table name followed by 
a dot (.). Whenever two or more table names are specified in the from clause of a 
block, all column names used within that block must be qualified. Using this 
approach, the above expression becomes: 

sum {select sales. vol 

from sales class loc 

where sales. item = class. item & class. type = "A" 
& sales .dept = loc. dept & loc. floor = 2} 



Finally, variables that assume rows of a designated table can be specified as 
values . In certain complex queries requiring comparisons among different rows of the 
same table, such row designator s are required to resolve ambiguity. In essence, this 
allows a single table to be treated as multiple tables in the select and where clauses. 
A row designator is associated with a table by adding a prefix consisting of the row 
designator name followed by a colon ( : ) to the table name in the from clause. Several 



8/86 



1-6 



AZ49-03A 



row designators may be associated with a single table. The row designator is used in 
the select clause and where clause like a table name to qualify a column name. 



Example 11 



For all employees who earn more than their managers, select the employee* s name 
and that of his manager. 

select employee .name manager .name 
from employee :emp manager :emp 

where employee. mgr = manager .emp_no & employee. sal > manager. sal 



These examples are intended as an introduction to basic features of the selection 
language. The information should allow the reader to write queries to satisfy a large 
class of data selection requirements. However, users should become familiar with the 
information in the remainder of this section for precise descriptions of the complete 
capabilities of the selection language. 



SYNTAX AND SEMANTICS OF THE SELECTION LANGUAGE 



A formal syntax is presented below using a metalanguage derived from Backus-Naur Form. 
The metalanguage symbols are defined as: 

< > denotes a syntactical construct 

::= means "is defined as" 

[ ] denotes zero or one occurrence of (optional) 

... denotes one or more occurrence of 

I denotes the logical inclusive "OR" 

The inclusion of an underscore character under any of the symbols distinguishes that 
symbol as not being a part of the metalanguage, but as being a part of the selection 
language syntax (see <bool__op> below) . 

<select_expr> ::= 

<set_value> I <select__set> 

<set__value> : : = 

<set__fn> { <select__set> } 

<set_fn> ::= 

<set_builtin> i <user_set__fn> 

<select_set> : : = 

<select_block> I <select__set> <set__op> <select__block> I 
{ <select__set> } 

<set_op> : : = 

union I inter I differ 

<select__block> : : = 

select <select__list> from <froffl__list> 

I select <s8lect_list> from <from_list> where <conditional> 

<select list> : ; = 

' i <select_item__list> 

I dup <select_item__list> I unique <select_item_list> 
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<select__itein__list> :: = 

<select_itera> I <select__item_list> <select__itera> 

<select_item> ::= 

<table_name> . * 1 <row_desig> . • I <expr> 

<expr> : : = 

<column_sp8c> ! <scalar_fn> (<arg_list>) 
<expr> <arith_op> <arithmetic_constant> 
<expr> <arith_op> <linus__variable> 
<expr> <arith__op> <set__value> 
<expr> <arith_op> <expr> I (<expr>) 

<colunin spec> : : = 

"^column naine^ I 'Ct.abl6 naine^ . ^coluiiin ijaius^ 
I <row_desig> . <colunin__nai[ne> 

<scalar__fn> : : = 

<scalar__builtin> I <user_scalar_fn> 

<arg__list> : : = 

<arg> i <arg__list>, <arg> 

<arg> : : = 

<expr> I <constant> I <set_value> 

<arith op> : : = 

<froai_list> : : = 

<table_item> I <table__item> <from__list> 

<table_itein> : : = 

<table_name> I <row_tab_pair> 

<row_tab_pair> ::= 

<row_desig>: <table_name> 

<conditional> : : = 

<terni> ! <conditional> <bool_op> <terin> 
! ''(<conditional> ) I (<conditional> ) 

<term> : : = 

<expr> <rel__op> <atoni> 

<rel op> : : = 

= 1 I > I < i >= I <= 

<bool_op> : : = 

&i I 

<atora> : : = 

<expr> I <constant> I <set_value> I { <select__block> } 

<constant> : : = 

<arithiDetic__constant> I <bit string_constant> j 
<character__string__constant> T <linus__variable> 

<linus_variable> ::= 
! <identif ier> 

<table_natne> : : = 

<identif ier> 

<row__desig> : : = 
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<column__name> : : = , 
<identif ier> 

<user_set_fn> ::= 
<fn_name> 

<user_scalar_fn> ::= 
<fn_name> 

<identif ier>: : = 

<letter>[<letter> |<digit> . . 

<letter>: : = 

AlBICiD IE IFiG |H II !J IK |L !M!N !0 !P !Q iR IS IT |U IV |W1X |Y |Z| 
albjcldlelflglhliijlkllimlnlolplqlrlsltlulvlwlxiylz 

<digit>::=. 

Oil 1213141516171819 



NOTES: A <set_buil tin> is one of the built-in set functions described in Section 
2. A <scalar_builtin> is one of the built-in scalar functions described 
in the same section. A <user_set_fn> and a <user_scalar__fn> must be 

declared according to the specifications contained in the declare 
request description (refer to Section 4). 



If <select_set>s are within a <select_set> , they may optionally be 
grouped by braces { } to explicitly specify the order of evaluation. If 
not explicitly specified, intersections and differences are evaluated 
prior to unions, and evaluation proceeds from left to right for operators 
of equivalent precedence. 



The <set_op>s union, inter, and differ correspond to the set operations 
union, intersection, and difference respectively. 



The <select_list>s of all <select_block>s within a <select_set> must be 
union-compatible; that is, corresponding columns must take their values 
from the same domain. Also, such <select_list>s may not contain <expr>s 
other than <column_spec>s . 



If the where clause is omitted from a <select__block> , all rows within the 
<from_list> qualify. 



A <select_list> of * indicates that all column values from the row are to 
be selected. If the <select_list> is a * , then the <from__list> must be a 
<table name>. 



A specification of dup within a <select_list> indicates that duplicate 
sets of selected values are not to be eliminated, whereas a specification 
of unique indicates that duplicates are to be eliminated. If neither is 
specified , the default rule applies . The default is dup if a <set_fn> is 
to be applied to the selected values and is unique otherwise. 

It should be noted that the use of scalar functions in the select clause 
may result in duplicate rows even though unique is specified. That is, 
LINUS applies scalar functions to column values returned from MRDS 
because of the select clause. MRDS actually does the duplicate 
elimination processing, but it does not know about built-in functions in 
the select clause. 
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A <select__itera> of <table_nanie> . * or <row_desig> . * indicates that all 
columns from the row are to be selected. A <table_name> is the name of a 
previously defined temporary table, or a table defined within the data 
base. A <row_desig> is a row designator that is associated with a 
<table name> in a <from list>. 



All <column__spec>s within an <expr> or <arg__list> must refer to column 
values from the same row. 



Items within an <expr> may optionally be grouped by parentheses () to 
explicitly determine the order of evaluation. If not explicitly 
specified, all multiplications (•) and divisions (/) are performed 
before any additions (+) or subtractions (-). Multiplications and 
divisions are performed from left to right, as are additions and 
subtractions . 



A <row__tab_pair> is used to specify the association of a row designator 
with a table. A <row_desig> must be unique for the entire 
<select block>. 



Items within a <conditional> may optionally be grouped by parentheses to 
explicitly specify the order of evaluation. If the order is not 
explicitly specified , the and ( &) operators are evaluated prior to the or 
(I) operators; the and evaluation proceeds from left to right for 
operators of equivalent precedence. 



The items <arithmetic_constant> , <bit_string__constant> , and 
<character_string_constant> are as defined in the PL/I Manual. An 
<identifier> is as defined in Multics PL/I with the exceptions that the 
dollar sign ($) is not allowed and the hyphen (-) is allowed, so long as it 
is not the first or last character of the < iden t if ier> . An <fn_name> is 
the same as the <identifier> except that the hyphen is not allowed. 
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SECTION 2 



BUILT-IN AND INSTALLATION-DEFINED FUNCTIONS 



BUILT-IN FUNCTIONS 



The available built-in functions in LINUS are listed alphabetically and are 
immediately followed by a detailed description. Several of the built-in functions 
are used in the numbered examples included in Section 1. 



abs count reverse 

after floor round 

avg index search 

before max substr 

ceil min sum 

concat mod verify 



Function: abs 



This is an arithmetic scalar function whose reference has the form: 
abs (X) 

The result of this function is the absolute value of X, where X must be a 
numeric data item. X can only be real and the result value is a float decimal 
(59). 



Function: after 



This is a string scalar function whose reference has the form: 
after (SI, S2) 

The result is that portion of SI that occurs to the right of the leftmost 
occurrence of S2 within SI. If S2 is a null string, the result is SI. If S2 
does not occur within SI, the result is a null string. For example: 

after ("abcde", "be") = "de" 

after ("abode"; "") = "abcde" 

after ("abcde",' "f") = "" 

after ("10101"b, "10"b) = "101"b 
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Function: avg 



This is an arithmetic set function whose reference 
has the form: 

avg {select X 
from . . . } 

The result is the average (mean) of all X values selected. For example: 

avg {select sal 
from emp 

where dept = "Shoe"} 
is the average salary of all employees in the shoe department. 



Function: before 



This is a string scalar function whose reference has the form: 
before (SI, S2) 

The result is that portion of SI that occurs to the left of the leftmost occurrence 
of S2 within SI. If S2 is a null string, the result is a null string. If S2 
does not lie within SI, then the result is SI. For example: 

before ("abode", "be") = "a" 

before ("abode", "") = "" 

before ("abode", "f") = "abode" 

before ("10101"b, "10"b) = ""b 



Function: ceil 

This is an arithmetic scalar function whose reference has the form: 
ceil (X) 

where X must be real. The result is the smallest integer (I) such that: 

I >= X 

For example: 

ceil (20.5) = 21 
ceil (-14.6) = -14 
ceil (12) = 12 
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Function: concat 



This is a string scalar function whose reference has the form: 

concat (SI, S2) 

The result is the concatenation of SI and S2. For example: 

concat ("abc", "de") = "abode" 
concat ("lOV'b, "01 "b) = "10101"b 



Function: count 

This is an arithmetic set function whose reference has the form: 

count {select XI X2 ... 
from . . . } 

The result is the number of sets of Xi which are selected. For example 

count {select name 
from emp 

where dept = "Shoe"} 
is the number of employees in the shoe department. 



Function: floor 

This is an arithmetic scalar function whose reference has the form: 
floor (X) 

where X is real. The result is the largest integer (I) such that: 

I <= X 

For example: 

floor (20.5) = 20 
floor (-14.6) = -15 
floor (12) r 12 
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Function: index 



This is a character string scalar function whose reference has the form: 
index (SI, S2) 

The result is an integer that is the position of the beginning of the leftmost 
occurrence of S2 within SI. If S2 is not in SI then the result is 0. If S2 is 
a null string, the result is 0. For example: 

index ("abode", "be") = 2 
index ("abode", "f") = 0 
index ("abode", "") = 0 



Function: max 

This is an arithmetic set function whose reference has the form: 

max {select X 
from . . . } 

The result is the largest X value selected. For example: 

max {select sal 
from emp 

where dept = "Shoe"} 
is the highest salary paid to any employee in the shoe department. 



Function: min 

This is an arithmetic set function whose reference has the form: 

min {select X 
from . . . } 

The result is the smallest X value selected. For example: 

min {select sal 
from emp 

where dept = "Shoe"} 
is the lowest salary paid to any employee in the shoe department. 
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Function: mod 



This is an arithmetic scalar function whose reference has the form: 
mod (X, Y) 

where X and Y are real. The result is X modulus Y, such that: 

if Y 0 then mod (X, Y) = X - Y * floor (X / Y) 
if Y = 0 then mod (X, Y) = X 

For example: 

mod (42, 5) = 2 

mod (129.2867, 25) = ii. 2867 

mod (10, 0) = 10 



Function: reverse 



This is a string scalar function whose reference has the form: 
reverse (S) 

The result is a string which is the reverse of the value of S. For example: 

reverse ("abode") = "edcba" 
reverse ("a") = "a" 
reverse ("") = 

reverse ("10110"b) = "01101"b 



Function: round 



This is an arithmetic scalar function whose reference has the form: 
round (X, Q) 

The result is a rounding of the value of X. When a value is rounded to n 
digits, the digits after the nth digit are dropped, and the nth digit is increased 
by 1 if the (n+1)th digit is 5 or greater for decimal, or 1 for binary. If X is 
float, then Q must be positive and the mantissa is rounded to Q digits. If X is 
fixed, it is rounded to a value that has Q fractional digits. For complex 
values, the function is defined by: 

round (X + Yi Q) = round (X, Q) + round (Y, Q)i 

For negative values the following algorithm is used: 

round (x) = round (abs(X)) * -1 

For example: 

round (183.62 9e6, 4) = 183- 6e6 

round (183.629, 2) = 183.63 

round (183.629, -1) = 180 

round (21.56 + 6.21i, 0) = 22 + 6i 
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Function : search 



This is a character string scalar function whose reference has the form: 
search (CI, C2) 

The result is an integer value that is the position in CI of the leftmost 
occurrence of any character contained in C2. If CI does not contain any character 
in C2, the result is 0. For example: 

search ("abode", "b") = 2 

search ("abode", "") = 0 

search ("abode", "f") = 0 

search ("abode", "be") = 2 



Function: substr 



This is a string scalar function whose reference has the form: 
substr (S, I, J) 
-or- 

substr (S, I) 

The result is that portion of S that begins with the Ith character and has 
length J (if J is present), or is that portion of S that begins with the Ith 
character and continues to the end of S (if J is not present). For example: 

substr ("abode", 3, 2) = "cd" 

substr ("abode", 3, 0) = "" 

substr ("abode", 3) = "cde" 

substr ("10101"b, 3) = "101"b 



Function: sum 

This is an arithmetic set function whose reference has the form: 

sum {select X 
from . . . } 

The result is the total of all selected values. For example: 

sum {select vol 
from sales 

where dept = "Shoe"} 
provides the total sales volume of the shoe department. 
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Function; verify 



This is a character string scalar function whose reference has the form: 
verify (CI, C2) 

The result is an integer value that is the position of the first character of CI that 
does not occur in C2. When CI contains only characters that are in C2, the result is 0. 
For example: 

verify ("xyz", "abc") = 1 
verify ("xyz", "xyz") = 0 
verify ("abode", "cba") =4 



WRITING NONSTANDARD FUNCTIONS 



Nonstandard (or installation-defined) functions may be written in any language 
that accepts and processes a standard Multics argument list. It is assumed that these 
functions are written by experienced programmers. (Refer to the linus command 
"declare" request in Section 5 for an example of declaring a nonstandard function.) | 



Scalar functions are passed a complete standard Multics argument list containing 
argument pointers and descriptor pointers for both the input arguments and the return 
argument. The call is equivalent to: 

return_val = fn_name$fn_name (in_arg1_, in_argri) ; 



Set functions are called differently in that they are called several times and 
require three procedure entry points. 



The first entry point is the init entry, which is called one time for evaluation 
of each set function. The method of evaluating a set function requires that data be 
accumulated in static storage. The purpose of this entry point is to initialize that 
static storage. The init entry is equivalent to: 

call fn_name$fn_name_init ; 



The second entry point is the calc entry, which is called one time for each set of 

selected values. Tnis entry is passed a complete standard Multics argument list 
containing argument pointers and descriptor pointers for all of the declared input 
arguments. The purpose of the calc entry point is to calculate (or accumulate) the 
value for the set function. The call to the calc entry is equivalent to: 

call fn__name$fn_name_calc (in__arg1_, in_argri) ; 



The third entry point of a set function is the assign entry. This entry is called 
after the calc entry has been called for all sets of selected values. The purpose of 
the assign entry is to actually assign a return value for the set function. The call to 
this entry is equivalent to: 

return__val = fn_name$fn__name_assign (); 



Two restrictions on arguments to nonstandard functions are: 



1. No • extents are permitted. 



8/86 
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2. Data types are restricted to those data types permitted in a MRDS data 
base. The use of pointers, entries, labels, structures, offsets, and 
arrays is not allowed. 



Example of the pll source for a scalar function: 

user_substr: proc ( character_argument ) returns ( char ( 6 )) ; 

del character_argument char (30); 
del substr builtin; 

return(substr (character_argument , 1, 6)); 

end user substr; 



Example of pll source for a set function: 
standard_deviation : proc; 

del number_of_calls fixed binary internal static; 

del (suin_of_x, sum_of_x_square) float decimal(59) internal static; 
del ( input_parameter , return_value ) float decimal(59); 

return; /* This entry point is only 
used for declaring the 
set function. */ 



standard_deviation_init : entry; 

/« Entry to initialize static data. 
This entry is used once before 
each evaluation of the set 
function. */ 

number_of_calls = 0; 
sum_of_x = 0.0; 
sum_of_x_square = 0.0; 
return ; 

standard_deviation_calc : entryCparameter ) ; 

/• Accumulate the needed 
information from the 
set of data. This entry 
point is called once for 
each row retrieved. •/ 



number_of__calls = number_of_calls + 1; 
sum^of_x = sum_of_x + parameter ; 
sum_of_x_square = sum of_x_square + 

Tparameter ** 2) ; 

return ; 

standard_deviation_assign : entry returns( float decimal ( 59 )) ; 
/* This entry is called when 
there are no more rows 
to be looked at. It 
determines what the final 
value of the set function 
will be. •/ 
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if number_of_calls > 1 then 

return_value = ( (number_of_calls * 
sum_of_x_square - 
sum_of_x »* 2) / 
(number of calls * (number of calls 
- 1))) »» .5; 

else 

return_value = 0.0; 
return ( return_value ) ; 
end standard deviation; 



2-9 



AZit9-03 



SECTION 3 



DATA BASE CREATION 



LINUS was designed primarily to allow users to access a centralized MRDS 
data base. However, it is also possible for users to define private data bases 
and utilize LINUS to access and maintain them. Users who wish to define a data 
base should refer to the MRDS Reference Manual, specifically to the introductory 
portion and to the description of the create_mrds_db command. 



Certain differences in terminology between LINUS and MRDS are: 



• A MRDS relation is a LINUS table . 

• A MRDS tuple is a LINUS row. 

• A MRDS attribute is a LINUS column . 

• A MRDS domain is a LINUS domain and is the set of values that an 
attribute (column) may assume. 



An example of the dept_store data base, discussed in Section 1, may be 
created by invoking a text editor and creating the source segment, dept store. cmdb: 



domain : 



name 


char 


(30) 


unal , 


emp no 


fixed 


bin 


(17) unal, 


dept 


char 


/ION 


unal , 


sal 


fixed 


dec 


(13,2) unal. 


coram 


fixed 


dec 


(13,2) unal, 


item 


fixed 


bin 


(35) unal. 


vol 


fixed 


bin 


(35) unal, 


supplier 


char 


(30) 


unal , 


floor 


fixed 


bin 


(8) unal, 


type 


char 


(M) 


unal; 



attribute : 

mgr emp_no ; 

relation: emp (name* emp_no dept mgr sal comra) , 
sales (dept* item* vol), 
supply (supplier* item* vol), 
loc (dept* floor), 
class (item* type); 
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Then the data base may be created by invoking the command: 
create mrds db dept store dept store -list 



The dept_store data base is now ready for loading, using the LINUS store request. 
(See linus command "store request" in Section 5.) 



NOTE: LINUS can also open a data base from a submodel. (Refer to the 
create_mrds_dsm command in the MRDS manual for a description of 
submodels, and their creation.) 
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SECTION 4 
REPORT WRITER 



SYSTEM OVERVIEW 



The LINUS report writer produces formatted reports from a relational data 
base. Through this facility the user can control: 

• page width and length 

• page breaks 

• page, group, and row headers/footers 

• counts, subcounts, totals, and subtotals 

• hyphenation of overlength values 

• reordering and excluding selected columns 

• duplicate suppression 

• column alignment, editing, folding, separators, titles, and widths 

• sorting on one or more columns 

• directing of the report to the terminal, a file, or an io switch 

• horizontal and vertical scrolling through the report 

The report writer is designed to serve the needs of the casual and experienced 

user. A casual user can have a default report layout provided by the system, 

while an experienced user can precisely define the report layout. 



Basic Operation 



The report writer system retrieves rows of information (tuples) from a 
relational data base and produces a formatted output report. The rows retrieved 
are specified via a selection expression. (Refer to Section 1 for additional 
information and selection examples.) 
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Formatting Options 



A formatted report is produced under the control of "formatting options." 
Formatting options consist of a name (for identity) and a set value. An example 
of a formatting option is: 

-page width 80 



where -page_width is the name of this option and "80" is the set value associated 
with the name. Formatting options which deal with columns require an "option 
identifier" to uniquely identify the column. For example, to set the width of a 
column, an identifier is needed to determine which column the width is to be set 
for. Identifiers csn be given ss the number of the column in the query, the 
name of the column as defined in the open model or submodel, or a star name 
which is matched against the column names. Examples of formatting options with 
identifiers are: 



-width salary 10 
-folding 3 fill 
-alignment ** center 



The formatting options are grouped into the following classifications: 



general report options 

control the overall characteristics of a report. They are assigned 
default values when linus is first invoked, but can be changed by the 
user at any time. These values are retained for the entire linus 
session. General report options consist of: 



-del imiter 

-format_document_control s 

-hyphenation 

-page_footer_value 

-page_header_value 

-page_length 

-page_wid th 

-title_line 

-truncation 



general column options 

control the overall characteristics of the columns, such as examining 
the value of certain columns to determine if a page break is to be 
generated. They are assigned default values for every new query, but 
can be changed by the user at any time. These values are retained 
only during the current query (i.e. , until the next new query is generated) . 
General column options consist of: 



-column_order 
-count 
-exclude 
-group 

-group_footer_trigger 
-group_footer_value 
-group_header_t rigger 
-group_header_value 
-outl ine 
-page break 



— IWW lUUt^CI VCIJ.UC 
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-subcount 
-subtotal 
-total 



specific column options 

control the characteristics of one specific column. They are assigned 
default values for every new query, but can be changed by the user at 
any time. These values are also retained only during the current 
query (i.e., until the next new query). These formatting options require 
an identifier to determine which column the particular option applies 
to. Specific column options consist of: 



-al ignment 
-ed iting 
-fold ing 
-separator 
-title 
-width 



The values of formatting options are listed and set through use of the 
list_format_options and set_format_options requests. These requests take control 
arguments which are the names of the formatting options. For example, to determine 
the current page width, enter: 



list_format_options -page_width 



and to change page width, enter: 



set_format_options -page_width 71 



A concept of "active" options is employed to make the system easier to use 
and to provide flexibility. For example, if a novice user does not set page 
headers, then no reference is made to them. If a user defines a page header, it 
then becomes active and appears in the output of the various reporting requests. 
If a user decides to eliminate a previously set page header, that is, by invoking 
the "set_format_options -page_header_value -default", it reverts back to the 
"inactive" state. This concept reduces the number of options listed when the 
user invokes the list_format_options request with no control arguments. The 
page_header_value is not listed if set to its default value as previously described. 



Specific column options are active at all times, whereas general column 

options and general report options are active only when their value is set 
different from the original default value. For example, if the page_width is 
assigned its default value by the system, or is reverted to by the user, it is 
not active. The moment that it is changed to a value different from its default, 
it is considered active. 
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Requests 



A number of requests are available for use in the creation of reports. 
Following is a brief summary of the report requests (refer to Section 5 for a 
detailed discussion of all requests): 



column_value 

returns the value of the specified column for the current row, previous 
row, or the next row. 



display 

retrieves selected data, creates a report, and displays the information 
or writes it to a file or an io switch. 



display_buil tins 

returns the current values for requested built-ins. 



format_line 

returns a single, quoted character string, formatted from an ioa_ control 
string . 



list_format_options 

displays the names and values of formatting options. 



Itrim 

returns a character string trimmed of specified characters on the left. 



picture 

returns one or more values processed through a specified PL/I picture. 



restore_format_options 

restores saved report layouts. 



rtrim 

returns a character string trimmed of specified characters on the right. 



save_format_options 

saves current values of formatting options for future use. 



set_format_options 

changes/sets report formatting options. 



string 

returns a single character string formed by concatenating all of its 
arguments together, separated by single spaces. 
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DEFAULT REPORT ELEMENTS 



Page Layout and Titles 



A page consists of a title line followed by as many rows as fit on the 
remainder of the page. The default title line is made up of one or more column 
titles, one column title for each column on the page. The column title is the 
column name (attribute name), which is found in the open submodel or model. If 
the column is the result of an expression or function invocation, the column 
title is "eN", where N begins at 1 and increases by 1 for each function invocation 
or expression encountered in the query. The row is made up of one or more 
columns, all concatenated together to form the row. The page width is 79 character 
positions and the page length is 66 lines, with 3 of these lines, at the top and 
bottom, reserved for margins. 



Separators 



A separator is provided for each column value and each column title. The 
default separator is two blanks placed between each pair of column titles and 
column values. The last column title or column value of a row has no separator. 



Folding and Width 



Sometimes when formatting a report, the user finds that the report elements 
do not fit within the defined width. To rectify this situation, "folding" takes 
place. Folding can occur in two different ways. The first is "truncation." 
Truncation means that the value is truncated to the defined width and the last 
displayable character is replaced by the truncation character(s) (normally "*"). 
The second is "filling." Filling means that portions of the value are m^oved 
down to the next line(s), allowing the newly formatted value to appear within 
its defined width. The format_document subroutine (described in the Subroutines 
Manual) is used to provide filling oF overlength values, and format document 
controls can optionally be supplied to provide greater control over the filling 
action. Filling takes place when a value is wider than its display width; when 
the value contains vertical tabs characters, horizontal tab characters, backspace 
characters, or newline characters; or when the alignment mode is set to "both." 
When column values do not have editing requests associated with them, the value 
is trimmed first (i.e., before the test for filling is done). Character and bit 
data types have trailing blanks trimmed, and all other data types have leading 
and trailing blanks trimmed. 



The default width for a column value is derived from the open model or 
submodel. The width chosen is the exact number of characters needed to contain 
the value after it is converted from the internal data base data type, to character 
format, via PL/I conversion rules. When the default width is used, the column 
value always fits, but this width can be reduced by the user. The reduction of 
the column width can cause folding to occur. Column folding can be set to 
"fill" or "truncate" and proceeds as described above. The default for column 
values is "fill." 



The concatenation of all column values and separators (used to determine 
row value) can cause row folding to occur. This happens when the resulting row 
is wider than the defined page width. In this case, columns which appear on or 
to the right of the right page boundary are moved down to the next line(s). The 
corresponding titles are moved so that they appear directly over the columns. 
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Columns whose widths are greater than the page width are automatically reduced 
to the page width. 



Alignment 



The alignment for column values is derived from the data type of the column, 
as defined in the open model or submodel. Character and bit strings default to 
"left alignment," decimal data with a non-zero scale defaults to "decimal point 
alignment," and all other data types default to "right alignment." The user can 
set the alignment of individual columns to left, right, center, both, or decimal 
point alignment. 



The alignment for a column title is center (i.e., the title is centered 
within its defined width). 



The alignment for a title line or a row is left (i.e., the title line or 
row is placed against the left page boundary). 



OPTIONAL REPORT ELEMENTS 



A number of optional features (for greater control over report appearance) 
are available for more sophisticated report formatting. These optional features 
are : 

• editing 

• headers/footers 

• column titles 

• active requests 

• page breaks 

• excluding columns 

• ordering of columns 

• grouping 

• outlining 

• totals and subtotals 

• counts and subcounts 

• separators and delimiters 

• embedded control lines and hyphenation 



Editing 



Editing can be specified for any column value; and is provided by linus 
active requests and Multics active functions. The column_value request is used 
to pass the value to other active requests, and the returned value is then 
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folded and aligned as described above (see "Folding and Alignment"). The report 
writer does not strip a level of quotes from the editing request; the first time 
quote stripping occurs is when ssu_$evaluate_active_string subsystem utilities 
procedure is invoked. Editing of column values is not provided by default. 



Headers /Footers 



A header or footer is a character string provided by the user. The character 
string can contain active requests, be made up of more than one "portion," and 
consist of more than one line. A delimiter character is used to separate the 
different portions of a header or footer. The delimiter character default is 
"!", but can be changed by the user. THe header/footer can consist of a left, 
right, and center page portion. 



Evaluation of a header/footer is a two-part operation that proceeds in the 
following manner: first, the header/footer is divided into its portions based 
on the delimiter character; and second, active requests are evaluated. Quote 
stripping is not done by the report writer during these two operations; the 
first time quote stripping occurs is when the ssu_$evaluate_active_string subsystem 
utilities procedure is invoked. The linus display_builtins active request can 
be used to obtain built-ins like the current page number in a header/footer, and 
the linus column_value active request can be used to obtain the value of a 
column . 



A header or footer can be made up of a left, right, and center page portion. 
These portions are determined by the delimiter characters. The portions are 
aligned to the left, right, and center of the page. Folding on headers/footers 
proceeds independently for each part. Portions of a header or footer (left, 
right, or center) with zero length are redistributed to other portions whose 
lengths are not zero. For example, if the page header contained only a center 
portion as : 



!! Sample Center Portion!! 



the text would be centered on the page, but would have the full page width 
available for the text. Similarly, a left portion or right portion only is 
aligned to the left or right of the page, but has the full page width available 
for placement of its text. Two exceptions to this action are when the header or 
footer has a left, right, and center portion, and the left or right portion has 
a zero length. For example: 

!left part! center part!! 

or 

!!center part!right part! 



In both cases the left or right part of the page is unavailable for placement of 
text (i.e., the space is not redistributed to the other two portions). 

If redistribution of the available page width is not desired, the placement 
of a single blank into a portion prevents the redistribution from taking place 
because the portion has a length greater than zero. For example: 

! ! Center Part! ! 



Headers and footers can be defined for a page, group, and a row. The first 
row that appears on the page is available for the page header, and the last row 
that appears on the page is available for the page footer. The first row of a 
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group is available for the group header, and the last row of a group is available 
for the group footer. The current row is available for use in the row header 
and row footer. 



Column Titles 



A column title is a character string that is placed above its associated 
column. The display width available for the title is inherited from its parent 
column, along with the folding action. If the title is exactly the same number 
of characters as the display width, it is placed without any folding or alignment 
action. If the title is shorter, it is centered within the display width. If 
the title is wider, it is truncated or filled, depending on its parent column's 
setting . 



Active Requests 



Active requests are used in headers/ footers to substitute values into the 
header/footer at the time the report is being formatted. For example, the Multics 
date active function can be used to provide the current date as part of the 
header or footer. 



Active requests are also used to provide editing for column values which 
become part of the row value. For example, the linus picture active request can 
be used to provide editing features such as dollar signs and commas. 



The user specifies linus active requests through the construct "[name STR]", 
where name is the name of the desired active request and STR is any argument(s) 
required by the active request. Multics active functions are invoked via the 
linus [execute] active request. They are specified by the user through the 
construct [execute name STR], where name is the name of the Multics active 
function and STR is any argument(s) required by the active function. The active 
function/request is evaluated and its returned value is substituted into the 
original string before folding and alignment take place. 



Page Breaks 



Page breaks can be set to occur when the value of one or more columns 
change. The occurrence of a new value in the column(s) being examined closes 
out the current page and a new page is started. The new row which caused the 
page break is not made available until the start of the next page. This allows 
the page footer to access the correct row (the last row on that page). 



Excluding Columns 



Columns selected in the query can be excluded from the row value. Through 
use of the [column_value ] active request, the column value can be obtained for 
placement elsewhere on the page. For example, a user may exclude the display of 
a column that is being used to determine when to generate page breaks, and place 
the value of the column in the page header with the column_value active request. 
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Ordering Of Columns 



Columns appear on the page in the order they were selected in the query. 
This order can be changed by the user without having to go back and change the 
query . 



Grouping 



One or more columns can be used to define a "group" of rows based on the 
values of these columns. The named columns make up a major to minor hierarchy 
and can be used in conjunction with the outlining, page break, subtotal, and 
subcount features. 



Outlining 



One or more columns can have duplicate values suppressed. If the value of 
the current column is the same as the previous value, then its display is suppressed 
unless it is the first line on a new page. 



If any named column is a member of the group of columns defined via the 
grouping feature, it and any columns more major in the hierarchy are outlined. 
A change in value of any one column displays all values of columns lower in the 
hierarchy in addition to the changed column. An exception is the first line on 
a new page, when duplicate values are never suppressed. 



Totals and Subtotals 



Totals and subtotals can be specified for columns. The totals and subtotals 
are placed directly under the associated columns. 



A column subtotal is generated when the value of the column(s) the subtotal 
is associated with changes. The subtotal can be associated with one or more 
columns. Several subtotals can be specified, each associated with different 
columns. Subtotals can be "reset" or "running." A column total is generated 
after the last input row is processed. 



The width, alignment, folding, and editing request for a total or subtotal 
is inherited from its parent column. During the generation of a total or subtotal, 
the column_value request returns the value of the total or subtotal, rather than 
the column value. When the parent column is excluded from the page, the total 
or subtotal associated with it is also excluded. An exception to this rule is 
when all of the columns have been excluded. They are provided in this case to 
produce reports containing some combination of subcounts, subtotals, counts, and 
totals only. 



Counts and Subcounts 



Counts and subcounts can be specified for columns, and work as described 
above under "Totals and Subtotals." A count or subcount counts occurrences of 
values, whereas a total or subtotal accumulates values. 
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Separators and Delimiters 



The separators used to separate 
other can be set to any string of 
delimiter character used to delimit 
can also be set by the user. 



column values and column titles from each 
displayable characters by the user. The 
the different portions of a header/ footer 



Format Document Controls and Hyphenation 



The report writer uses the format document_ subroutine (refer to the Subroutines 
Manual) to "fill" overlength text." A user can embed format document control 
lines in text to achieve greater control of the filling action. A user can also 
specify that hyphenation of words should be attempted when filling overlength 
text , 



FULL PAGE FORMATTING 



The report writer system formats a full page before any output is provided. 
It operates in this fashion because it is sometimes necessary to back up on a 
page and defer report elements to the next page so that associated report elements 
remain on the same page. A full page with all report elements present is outlined 
in the following diagram. 

Formatted Page 



PAGE HEADER 



TITLE BLOCK 



DETAIL BLOCK 1 



4- expanded in diagram below 



DETAIL BLOCK_N 
PAGE FOOTER 



Detail Block 



GROUP HEADER 
ROW HEADER 



ROW VALUE 
SUBTOTAL BLOCK 



SUBCOUNT BLOCK 



TOTAL BLOCK 



COUNT BLOCK 

ROW FOOTER 



GROUP FOOTER 
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All of the defined report elements are optional, but at least one must be 
present or a zero length page is the result. A zero length page is treated as 
an error and the report formatting is terminated. 

Backing up on a page is accomplished via a detection/prevention method, and 
proceeds as follows: 



1. The page header, if present, is processed first. If the page header 
does not fit on the page, it is treated as an error and the report 
formatting is terminated. The formatted page header can fill the complete 
page if no other report elements are defined. 



2. The title line, if present, is processed next. If the title line does 
not fit on the page, it is treated as an error and the report formatting 
is terminated. The formatted title block can fill the complete page 
if no other report elements are defined. 



3. The detail block is processed next. A detail block can be made up of 
a group header, a row header, a row value, a subtotal block, a subcount 
block, a total block, a count block, a row footer, and a group footer. 
These different elements are treated as one unit and must all appear 
on one page or the detail block is deferred to the next page. If any 
of these elements are defined, then at least one detail block must fit 
on the page or it is treated as an error and the report formatting is 
terminated. The formatted detail block can fill the complete page if 
no other report elements are defined. 



a. The group header, if present, is processed first. If the current 
row is the first row of the report, or if the column associated 
with the -group_header_trigger option has just changed with the 
current row, the header is generated. If the group header does 
not fit on the page, the detail block is deferred to the next 
page, provided one detail block is already placed on the page. 



b. The row header, if present, is processed next. If the row header 
does not fit on the page, the detail block is deferred to the 
next page, provided one detail block is already placed on the 
page. 



c. The row value, if present, is processed next. If the row value 
does not fit on the page, the detail block is deferred to the 
next page, provided one detail block is already placed on the 
page. The editing requests associated with any columns are evaluated 
before an attempt is made to place the row value on the page. If 
the row value is deferred to the next page for any reason, the 
editing requests associated with the columns are evaluated again 
when the row value is processed on the next page. This is necessary 
to ensure that obtained values, such as the page_number display 
built-in are correct. For users who are doing calculations based 
on accumulations, this could produce incorrect calculations. That 
is, the value of a row could be accumulated more than once. The 
previously processed row display built— in provides a mechanism to 
ensure thi"s does not happen. If the value of this built-in is 
true, a user doing accumulations would not add in the current row 
value as it was already added in when the editing requests for 
the row were processed the first time. 



d. The row subtotal, if present, is processed next. If subtotal 
generation is necessary, and the row subtotal does not fit on the 
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page, the detail block is deferred to the next page, provided one 
detail block is already placed on the page. The editing requests 
associated with any subtotals are only evaluated when subtotal 
generation is done, and proceed as described above under "row 
value" editing requests evaluation. The previously_processed_row 
display built-in also works as described above. 



e. The row subcount, if present, is processed next. It proceeds as 
described above under row subtotal (item d). 



f. The row total, if present, is processed next. If total generation 
is necessary, and the row total does not fit on the page, the 
detail block is deferred to the next page, provided one detail 
block is already placed on the page. The editing requests associated 
with any totals are only evaluated when total generation is done, 
and proceed as described above under "row value" editing requests 
evaluation. The prev iously_processed_row display built-in also 
works as described above. 



g. The row count, if present, is processed next. It proceeds as 
described above under row subtotal (item d) . 



h. The row footer, if present, is processed next. If the row footer 
does not fit on the page, the detail block is deferred to the 
next page, provided one detail block is already placed on the 
page. 



i. The group footer, if present, is processed last. If the current 
row is the last row of the report, or the column associated with 
the -group footer_tr igger option is about to change with the next 
row, the footer is generated. If the group footer does not fit 
on the page, the detail block is deferred to the next page, provided 
one detail block is already placed on the page. 



4. The page footer, if present, is processed last. If the page footer 
does not fit on the page, the last detail block on the page is removed 
and the page footer is processed again. Active requests found in the 
footer are evaluated again to ensure correct processing of display 
built-ins like current_row_number . If the page footer still does not 
fit, another detail block is removed from the page and the footer is 
evaluated again. This process continues until the footer fits, or 
there are no more detail blocks to remove from the page. The first 
detail block that appears on the page is never removed, and if its 
removal is necessary to provide a fit for the page footer, it is 
treated as an error and report formatting is terminated. 
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USER SESSION 



The remainder of this section consists of report writer examples organized 
into a sample user session. User-typed lines and lines displayed by the system 
are shown together in the example. To differentiate between these lines, an 
exclamation mark (!) precedes user-typed text. This is done only to distinquish 
user text from system-generated text; it is not to be included as part of the 
input line. Also, a "carriage return" (moving the display mechanism to the 
first column of the next line, called a newline or NL on Multics) is implied at 
the end of every user-typed line. Line numbers are also included in the examples 
for purposes of commentary immediately following the example. 



Note: Because of page constraints in this document, certain character 

strings of data used in examples may not match exactly the information 
as seen on a user's terminal. That is, the character strings in 
examples may be folded or multiple-lined, whereas the actual 
interactive (live) session may display the same information on a 
single line or multiple lines with different line breaks than 
shown here. Additionally, blank lines have been removed in the 
examples for space consideration in this document. In most cases 
this can be recognized by the reader. For example: 

55 ! linus: display -page 1 

59 (system display) 

Only one space is used to separate the two lines in the example, 
but the line numbers to the left of the lines imply there are 
actually three spaces here. 



Following is a list of request and control argument abbreviations used in 
the examples. They are included here for the purpose of saving the reader from 
referring to other sections if a term is unfamiliar. 



REQUEST ABBREVIATIONS 



civ column_value 

di display 

dib display_builtins 

e execute 

ec exec_com 

iq input_query 

Idb list_db 

Is list (Multics command level) 

Isfo list_format_options 

o open 

pr print (Multics command level) 

q quit 

rsfo restore_format options 

sfo set_format_optTons 

ss set_scope 

svfo save_format_options 

tq translate query 



CONTROL ARGUMENT ABBREVIATIONS 

-a -all 

-al -alignment 

-bf -brief 

=00 -column_order 

-dm -delimiter 

-ed -editing 
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«-6X 


c A t uu e 


-fo 


—fores 




1 H "5 n 0 

— iWiU J-lJQ 


-git 


-group footer trigger 


-gf V 


—group footer value 


rrVll- 

-griu 


—group iicaJer tr xgger 


-ghv 


—group header value 


-gr 


—group 


— 1 U 


— it©r3tion 


-Vr 




— kr p 


— k G 6 p r 6 po r t 


M VI 




-r.f 




— or 




— or p 




~out 




-po 




— pi V 


page looter vaiue 


-pg 


-page 


— ph V 


—page header value 


-nl 
-pi 




— pw 


— page WIU Uil 


— r 1 V 


—row footer value 


— rhv 


—row header value 


M K Q 


— 1^ A Q 0 h 


— S6 


—selection expression 


—Sep 


— separa tor 


el- V 
— Sli U 


— SUD to tai 


— uc 


— truncation — '-Jn— —truncate 


— tu 


—temp dir 


-ti 


-term inal_in put 


-tl 


-title_line 


-tt 


-total 


-ttl 


-title 


-wid 


-width 
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General Report Options-1 



1 ! linus -it 

2 ! linus: o employee r 

3 • linus: ss employee r u 

4 ! linus: Idb -Ig 

TABLE COLUMN DECLARATION DOMAIN TYPE 

employee (perm) 



name 


char 


(10) 




name 


key 


job 








job 






fixed 


dec 


(2) unal 




key index 


salary 








salary 






fixed 


dec 


(7,2) unal 




data index 


age 








age 






fixed 


dec 


(2) unal 




data index 


sex 


char 


(1) 




sex 


key index 


family 


char 


(1) 




family 


data 


state 


char 


(2) 




state 


data index 


city 


char 


(13) 




city 


data index 



5 ! linus: Isfo -a 

-delimiter 

-format_document_controls 
-hyphenation 
-page_footer_value 
-page_header_value 
-page_length 
-page_width 
-title_line 
-truncation 

6 ! linus: Isfo 

All of the formatting options are set to their default values. 
There are no column options defined. 

7 ! linus: sfo -pw 0 

8 ! linus: Isfo 

-page_width "0" 

9 ! linus: sfo -pw -default 
10 ! linus: Isfo 

All of the formatting options are set to their default values. 
There are no column options defined. 



It I n 

"off" 

"Off" 

till 

till 

"66" 

njgn 

"on" 

n« II 



4-16 



AZ49-03 



line 1-4 

Invoke linus, open, set scope, and list information about the data base. 



1 ine 5 

List the names and values of "all" report formatting options. All of 
the displayed values in this case are "default" values. These options 
are the "general report options." They remain in effect across the 
entire linus session. For example, if the page width is changed, it 
remains at this new value until it is explicitly changed back, or until 
the linus session is terminated. 



-dm 
-fdc 



It I II 



"off" 



-hyphenation 

-pfv "" 
-phv "" 

-Pl 
-pw 



-tl 
-tc 



"65" 
It Y g II 

"on" 
It* II 



character used to delimit portions of header/footer. 

used when filling overlength character strings. If 
"off," ignore embedded controls. 

"off" used when filling overlength character strings. If 
"off," do not attempt to hyphenate words. 

footer placed at bottom of each page. 

header placed at top of each page. 

length of each formatted page (number of lines). 

width of each formatted page (number of character 
positions) . 

print the title line. 

character that indicates truncation has occurred. 



line 6-10 

List options, set page width, list options again, reset page width, and 
list options once again. If line 10 included the -all control argument, 
the display would be the same as that following line 5. 



4-17 



AZ49-03 



Specific Column Options 



The following example looks at "specific column options." These options are 
always listed and are assigned new default values each time a new query is processed. 



14 



22 



30 



38 



46 



53 



linus: iq -bf 

select * from employee 

linus: tq 
linus: Isfo 
-alignment age 
-alignment city 
-alignment family 
-alignment job 
-alignment name 
-alignment salary 
-alignment sex 
-alignment state 
-editing age 
-editing city 
-editing family 
-editing job 
-editing name 
-editing salary 
-editing sex 
-editing state 
-folding age 
-folding city 
-folding family 
-folding job 
-folding name 
-folding salary 
-folding sex 
-folding state 
-separator age 
-separator city 
-separator family 
-separator job 
-separator name 
-separator salary 
-separator sex 
-separator state 
-title age 
-title city 
-title family 
-title job 
-title name 
-title salary 
-title sex 
-title state 
-width age 
-width city 
-width family 
-width job 
-width name 
-width salary 
-width sex 
-width state 



"right" 

"left" 

"left" 

"right" 

"left" 

"decimal 8" 

"left" 

"left" 

nn 
nil 
nti 
lilt 
lilt 
ti II 
ti II 
nil 

"fill" 

"fill" 

"fill" 

"fill" 

"fill" 

"fill" 

"fill" 

"fill" 
It II 



"age" 

"city" 

"family" 

"job" 

"name" 

"salary" 

"sex" 

"state" 
it^ It 

"13" 
111 II 

115 II 

"10" 

"10" 
If] II 

"2" 
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line 1-5 

Invoke input_query, build query, translate query, and list the names and 
values of the column options. 

line 6-13 

System display — the alignment option specifies how a value is to be 
aligned within its display width. 

• Character and bit strings default to left-alignment. 

• Decimal data with a non-zero scale defaults to 
decimal -point-alignment . 

• All other data types default to right-alignment, 
line 14-21 

System display — the editing option provides additional editing for 
column values. (Default is no editing) 

line 22-29 

System display — the folding option specifies the action taken when the 
column value exceeds the display width for the column. (Default is 
fill) 

line 30-37 

System display — the separator option specifies the character string 
that separates the specified column from the following column. (Default 
is two blanks) 

line 38-45 

System display — the title option specifies the character string to be 
placed at the top of the page above the column. (Default is the name 
found in the open model or submodel) 

line 46-53 

System display — the width option specifies the display width of the 
detail line of the column. (Default is the number of characters needed 
after conversion to character format) 
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The following examples look at a report utilizing the available specific 
column options. 



55 ! linus: di -pg 1 
59 name job 



salary 



age 



St 

at 
e 



city 



66 


abel 


1 


14555. 


01 


36 


m 


s 


ak 


juneau 


67 


abell 


2 


13000. 


01 


55 


f 


m 


az 


phoenix 


68 


abernathy 


3 


12500. 


01 


61 


m 


d 


ca 


fresno 


69 


abodoura 


5 


12900. 


01 


61 


m 


m 


ca 


Sacramento 


70 


aboe 


4 


10201. 


01 


41 


f 


s 


ca 


los angeles 


71 


abraham 


6 


15000. 


01 


25 


f 


d 


ca 


san diego 


72 


abrahms 


7 


14300. 


01 


35 


m 


s 


ca 


san francisco 




. (45 data 


lines ) 
















118 


baker 


1 


12000. 


10 


71 


m 


s 


il 


Springfield 



line 55 

Display page 1. Data is retrieved from the data base and formatted by 
default parameters. 

line 59-118 

System display 
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120 ! linus: Isfo -wid state 

-width state "2" 

123 ! linus: sfo -wid state 5 
125 ! linus: di -pg 1 

129 name job salary age s f state city 

e a 
X m 

i 

1 

y 



136 


abel 


1 


14555. 01 


36 


m 


s 


ak 


juneau 


137 


abell 


2 


13000.01 


55 


f 


m 


az 


phoenix 


138 


abernathy 


3 


12500. 01 


61 


m 


d 


ca 


fresno 


139 


abodoura 


5 


12900. 01 


61 


m 


tn 


ca 


Sacramento 


140 


aboe 


4 


10201,01 


41 


f 


s 


ca 


Ids angeles 


141 


abraham 


6 


15000. 01 


25 


f 


d 


ca 


san diego 


142 


abrahras 


7 


14300. 01 


35 


m 


s 


ca 


san francisco 




. (45 data 


lines) 














188 


baker 


1 


12000. 10 


71 


m 


s 


il 


Springfield 



line 120 

List the width value of the "state" column, 
line 123-125 

Set the width value for state column to "5" from its default value of 
"2" and display page 1. 

line 129-188 

System display — note the difference in the state column header on line 
129 from that displayed on line 59-61. 
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190 ! linus: Isfo -wid 
-width city 



193 ! linus: 
195 ! linus: 



199 



name 



sfo -wid 
di -pg 1 

job 



"13" 



8 10 



salary 



age 



state 



city 



on A 


abe 1 


1 
1 


1 li ccc n 1 


do 


m 


s 


d K 


J un c a u 


o n v 


a De 1 i 




1 oUUU . U 1 




I 


m 


a z 


p n o e n 1 X 




abernathy 


5 


1 ocn n A 1 
1 (CDU U . U 1 


(s 1 

0 1 


in 


A 
Q 


c a 


I resno 


209 


abodoura 


5 


12900. 01 


61 


m 


m 


ca 


Sacramento 


210 


aboe 


4 


10201. 01 


41 


f 


s 


ca 


los 


21 1 
















angeles 


212 


abraham 


6 


15000. 01 


25 


f 


d 


ca 


san diego 


213 


abrahms 


7 


14300. 01 


35 


m 


s 


ca 


san 


214 
















f rancisco 




(37 data 


lines) 














252 


arnold 


22 


18210. 01 


53 


f 


d 


pa 


philadelph 


253 
















ia 


254 


ashman 


23 


12400. 01 


52 


m 


s 


tn 


chattanoog 


255 
















a 


256 


ashworth 


24 


9301. 01 


61 


f 


ID 


tx 


austin 


257 


asin 


1 


15100. 01 


51 


m 


d 


tx 


dallas 


258 


auburn 


2 


13101.01 


70 


f 


s 


vt 


rutland 



line 190 

List the width value of column 8 (city) 
line 193-195 

Set the width value of the 8th column to "10" from its default value of 
"13" and display page 1. 



line 199-258 

System display — note the difference under the city header (line 210-214) 
from that displayed on line 140-142. Also notice the not-so-pleasant 
breakup of line 252-255. This is an example of column "filling." 
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260 ! sfo -wid 8 -def aul t ; Isfo -wid name 
-width name "10" 



263 I linus: sfo -wid name 7 -fold name truncate 
265 ! linus: di -pg 1 



270 



name 



job 



salary 



age 



state 



city 



277 


abell 


2 


13000. 


01 


55 


f 


m 


az 


phoenix 


278 


aberna* 


3 


12500. 


01 


61 


m 


d 


ca 


fresno 


279 


abodou* 


5 


12900. 


01 


61 


m 


m 


ca 


Sacramento 


280 


aboe 


4 


10201. 


01 


41 


f 


s 


ca 


los angeles 




. (47 data 


lines) 
















328 


baker 


1 


12000. 


10 


71 


m 


s 


il 


Springfield 



line 260 

Set the width value of column 8 (city) to its default value (13) and list the 
width value of the name column. Notice that multiple linus requests can be 
included in a single request line by utilizing the request termination 
character (; ) between requests. Any number of requests may be included on a 
line using this format. 

line 263-265 

Set the width value of the name column to "7", truncate the data listed under 
the name column, and display page 1. 

line 269-279 

System display — note the difference under name header (line 278-279) from 
that displayed on line 208-209. 



330 ! sfo -Sep »» " 



332 ! linus: 
336 name 



343 
344 
345 
346 
347 



di -pg 1 
job 



abel 

abell 

aberna* 

abodou* 

aboe 



(H7 fiaha lines) 



salary 



395 baker 



14555. 01 
13000. 01 
12500. 01 
12900.01 
10201. 01 



12000.10 I 



;e 


s 


f 


state 


city 




e 


a 








X 


m 










i 










1 










y 






36 


1 m 


s 


ak 


juneau 


55 


\ f 


m 


az 


phoenix 


61 


1 m 


u 


ca 


fresno 


61 


1 m 


m 


ca 


Sacramento 


41 


! f 


s 


ca 


los angeles 


71 


1 m 


1 s 


il 


Springfield 
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line 330-332 

Set the column separator value to "<SP>1<SP>" from its default value of 
<SP><SP> (two blanks) and display page 1. 

line 336-395 

System display — note that the columns have shifted to the right because the 
separator was increased to three character positions. Previous example 
separators were only two character positions. 



397 
398 
399 
400 ! 



! linus: sfo -al age left -ed salary -prompt 

Enter -editing salary. 
! [pic $zz,zz9v.99 [civ salary]] 



402 ! linus: di -pg 1 



406 



413 



name 



abel 
abell 
aberna* 
abodou* 



job 



salary 



$14,555.01 
$13,000.01 
$12, 500. 01 
$12, 900.01 



I age 


! s 


f 


state 


city 




! e 


a 








1 X 


tn 










i 










1 










y 






1 36 


I m 


s 


ak 


juneau 


1 55 


! f 


m 


az 


phoenix 


1 61 


1 m 


d 


ca 


fr esno 


! 61 


I m 


m 


ca 


Sacramento 



464 



. (48 data lines) 

baker I 1 I $12,000.10 



71 



I m i s i il 



I Springfield 



line 397 

Set alignment value for age column to "left" from its default value of 
"right," and invoke the editing option with prompt. 

line 399-402 

Edit request, termination, and display page 1. 

line 406 - 464 

System display — note that the information under the age column is now 
aligned to the left of the column and the data under the salary column contains 
the "$" and "," characters. 
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466 ! linus: Isfo -ttl «» 

"title age 

-title city 

-title family 

-title job 

-title name 

-title salary 

-title sex 

-title state 



476 
477 
478 
479 
480 
481 
482 

483 
484 
485 
486 
487 
488 
489 
490 
491 
492 
493 
494 
495 
496 
497 
498 
499 
500 

502 

506 



"age" 

"city" 

"family" 

"job" 

"name" 

"salary" 

It sex" 

"state" 



linus : 
Enter ■ 
NAME 

Enter - 
JOB 

Enter • 
SALARY 

Enter - 
AGE 

Enter • 
SEX 

Enter ■ 
FAMILY 

Enter • 
STATE 

Enter 
CITY 



sfo -al age -default ;sfo -ttl (1 2 3 4 5 6 7 8) -prompt 
•title name. 



•title job. 
•title salary, 
•title age. 
•title sex. 
•title family, 
•title state. 



-title city. 



linus: di -pg 1 



565 



NAME i 


JOB 1 


SALARY 1 


AGE 


I s 


i F 


STATE 


1 CITY 










1 E 


! A 














X 


' M 
I 
















L 
















Y 






abel I 


1 1 


$14,555.01 ! 


36 


! m 


s 


ak 


juneau 


abell 1 


2 1 


$13,000.01 1 


55 


I f 


m 


az 


phoenix 


aberna* I 


3 1 


$12,500.01 1 


61 


m 


d 


ca 


fresno 


(49 data 


lines) 














baker | 


1 1 


$12,000.10 1 


71 


■ m 
1 ul 


s 


il 


Springfield 



line 466 

List the title values of all columns, 
line 476-502 

Set the title value for all columns to new values (in this case, all 
have been changed frois lowercase to uppercase), and display page 1. 

line 506-565 

System display — note that the column header values on line 506 are 
different from that displayed on line 406. 
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General Report Options-2 



The following examples look at the "general report options" and are an 
extension to the example shown above under "General Report Options-1." 



1 ! linus: sfo -pi 26 
3 ! linus: di -pg 1 



NAME 1 


JOB 1 


SALARY i 


AGE 


! S 


! F 


STATE 


! CITY 










h 


A 














X 


M 

I 
















L 
















Y 






abel 1 


1 1 


$14,555.01 i 


36 


m 


s 


ak 


juneau 


abell 1 


2 1 


$13,000.01 1 


55 


f 


m 


az 


phoenix 


aberna* | 


3 i 


$12,500.01 1 


61 


m 


d 


ca 


fresno 


(9 data 


lines) 














agee | 


^^ 1 


$30,900.01 1 


70 


1 m 


s 


hi 


honolulu 



line 1-3 

Set the page length value to "26" from its default value of "66," and 
display page 1. 

line 7-27 

System display — note that the report length has decreased. There are 
now 20 text lines and three "margin lines" at the top and at the bottom 
of the page. When the report is sent to a file (for later printing), 
these six margin lines are put in the report by the line printer software. 
This produces the same page format, whether viewed at a terminal or on 
hardcopy . 
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29 ! linus: sfo -phv -prompt 

30 Enter -page_lieader_value . 

31 ! ![e date] 'Sample Report! [e time]! 

32 ! ! ! ! ! 

33 ! y " 

35 ! linus: di -pg 1 

39 OM/29/83 Sample Report 10.26 



NAMF ! 


.TOR ! 


•^AI A R Y ! 


AGF 


S 


F 


STATF 


1 CITY 










E 


A 














X 


, M 

I 
















L 
















Y 






abel 1 


1 ! 


$14,555.01 1 


36 


1 ro 


s 


ak 


1 juneau 


abell I 


2 ! 


$13,000.01 1 


55 


f 


m 


az 


phoenix 


aberna* | 


3 ! 


$12,500.01 1 


61 


m 


d 


ca 


fresno 


. (7 data 


lines) 














adkins | 


11 1 


$20,700.01 1 


75 


! m 


m 


fl 


key west 



line 29 

Set the page header value when prompted by the system. 

line 30 

System display — prompt 

line 31-35 

Set page header to contents of line 31-32 (two header lines), terminate, 
and display page 1. 

line 39-58 

System display — note that a page header (line 39) is now included as 
part of the report. This two-line page header reduces the page content 
of the report (i.e., the report now consists of 18 data lines whereas 
the previous example contained 20 lines). The page header fills the 
entire page width, but the column values do not. If the page width is 
set to zero, the display request calculates the page width to be an 
exact fit (i.e., contains all of the column values and separators). 
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60 ! linus: sfo -pw 0 
62 ! linus: di -pg 1 



66 04/29/83 Sample Report 10:26 



NAME i 


JOB ! 


SALARY i 


AGE 


s 


P 




! r TT Y 










r 
n 


A 
H 






j 

! 


j 






X 


M 
I 








j 








L 
















Y 






abel 1 


1 1 


$14,555.01 ! 


36 


m 


s 


ak 


juneau 


abell 1 


2 1 


$13,000.01 1 


55 


f 


m 


az 


phoenix 


aberna* | 


3 1 


$12,500.01 ! 


61 


m 


d 


ca 


fresno 


(7 data 


lines) 














adkins | 


11 1 


$20,700.01 1 


75 


1 ni 


! m 


fl 


key west 



line 60-62 

Set the page width value to "0" from its default of "79," and display 
page 1. 

line 66,85 

System display — note that the page header is now centered over the 
columns. Setting the page width to zero has one disadvantage: when set 
to some positive integer and a column width exceeds the page width, that 
column width is reduced to the page width. For example, if the page 
width is set to 80 and the width for a column is set to 1024, the column 
width is reduced by the display request to 80. The reduction of a 
column display width does not take place when the page width is set to 
zero . 
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87 ! linus: sfo -pfv -prompt 

88 Enter -page footer value. 

89 ! ! ! ! ! 

90 ! !!- Page [dib page_number3 -!! 

91 ! . 

93 ! linus: di -pg 1 



OU /2Q/8^ 




Sample Report 






1 n • pfi 


NAME 1 


.TOR 


SALARY 1 


AGE 


S 


F 
A 




! C TTY 


} 
I 
J 
I 








E 
X 


M 

T 
T 

Li* 

Y 






abel 1 


1 


$14,555.01 1 


36 


m 


s 


ak 


juneau 


abell i 


2 


$13,000.01 1 


55 


! f 


m 


az 


phoenix 


aberna* | 


3 


$12,500. 01 I 


61 


m 


d 


ca 


fresno 


abodou* 1 


5 


$12,900.01 i 


61 


m 




ca 


Sacramento 


aboe 1 


4 


$10,201.01 ! 


41 


f 


s 


ca 


los angeles 


abraham | 


6 


$15,000.01 I 


25 


f 


d 


ca 


san diego 


abrahins | 


7 


$14,300.01 1 


35 


m 


s 


ca 


san francisco 


acee { 


8 


$12,700.01 1 


34 


f 


m 


CO 


denver 


acord | 


9 


$10,500.01 1 


41 


m 


d 


Ct 


hartford 



116 - Page 1 - 



line 87 

Set the page footer value when prompted by the system. 

line 88 

System display — prompt 

line 89-93 

Set the page footer to contents of line 89-90 (two footer lines), terminate, 
and display page 1. 

line 97-116 

System display — note that a page footer (line 116) is now included as 
part of the report. This two-line page footer reduces the page content 
of the report by another two lines (now 16 lines of data between header 
and footer). 
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118 ! linus: sfo -pi -def aul t ;di -pg 1 



122 04/29/83 Sample Report 10:26 



NAME 1 


JOB 1 


SALARY 1 


AGE 


S 


F 


STATE 


1 CITY 


1 








E 


A 






1 


i 
1 






X 


M 
I 
















L 
















Y 






abel ! 


1 ! 


$14,555.01 ! 


36 


m 


s 


ak 


juneau 


abell 1 


2 1 


$1 3> 000. 01 1 


55 


I 


m 


az 


phoenix 


aberna* | 


3 1 


$12,500.01 1 


61 


rn 


d 


ca 


fresno 


. (45 data 


lines) 














azer | 


5 1 


$12,600.01 1 


44 


! m 


s 


va 


i norfork 



181 - Page 1 - 



line 118 

Set the page length to "default" (66 lines) from its previous setting of 
"26" (see line 1 of this example set). 

line 122-181 

System display — note that the page now consists of 66 lines (3 blank 
margin lines at top and bottom and 60 lines of report). 
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183 ! linus: sfo -tc <MORE>;di -pg 1 



187 04/29/83 Sample Report 10:26 



1 89 


NAME 1 


JOB 1 


OAT A D V 

oALAn I 


1 ft rr 1 
1 Auk. 


c 
o 


rr 
r 


C T A TC" 


1 r TT V 










T7 
C. 


A 








[ 
1 


j 
[ 




J 

! 


V 
A 


n 

T 

X 


















L 






194 




1 








Y 








abel 1 


1 1 


$14, 555. 01 


! 36 


m 


s 


ak 


juneau 




abell ! 


2 ! 


$1 3, 000. 01 


! 55 


f 


m 


az 


phoenix 


198 


a<MORE> 1 


3 ! 


$12, 500. 01 


! 61 


m 


d 


ca 


fresno 


199 


a<MORE> 1 


5 1 


$12, 900. 01 


1 61 


in 


m 


ca 


1 Sacramento 




aboe ! 


4 1 


$10, 201. 01 


i 41 


f 


s 


ca 


los angeles 




. (43 data 


lines) 














244 


azer | 


5 1 


$12, 600. 01 


i 44 


m 


s 


va 


! norfork 


246 








- Page 1 











line 183 

Set the truncation value to "<MORE>" from its previous default value of 
"*," and display page 1. Refer to line 263 in the "Specific Column 
Options" example (above) where the width value of the name column was 
set to "7" and the folding option, with truncation (Default = *), was 
turned on for the name column. 

line 187-246 

System display — note the different truncation of the name column values 
(line 198-199 ) from that displayed in the earlier example identified 
above (line 278,279). 
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248 ! linus: sfo -tl off;di -pg 3 



252 


04/29/83 




Sample 


Report 






10: 26 


254 


c<MORE> 1 


3 1 


$12,501.01 1 


76 1 m 


m 


ca 


1 san francisco 




cummins | 


4 ! 


$10,100.01 ! 


78 1 f 


d 


CO 


i denver 




W U 1/ V.^ II X li 1 


D 1 


*i p Ann ni ' 


U ^ 1 111 


e 




1 IICII UXV^IU 




. (52 data 


lines) 












309 


goodwyn | 


15 ! 


$12,400.01 I 


39 1 f 


H 
a 


Ct 


1 hartford 



311 - Page 3 - 



313 ! linus: sfo -tl on 



line 248 

Set the title line value to "off" from its previous default value of 
"on," and this time display page 3. Turning the title line off inhibits 
the column header or title display from that displayed in the previous 
example (line 189-194). 

line 313 

Set the title line value to "on." This restores the display of column 
header or title lines. 
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SPECIAL EDITING OF A REPORT 



The following example shows how to utilize a user-defined exec_com and 
interact with the editing request. 



1 

3 
4 

5 
6 
7 
8 
9 
10 
11 
12 



27 
28 



75 
77 



linus: sfo -wid sex 

linus : . .ted 

a 

Aversion 2 

&trace off 

&if &[e equal m &1 ] 

&then &return male 

&else &return female 

\f 

w sex_lookup.lec 

q 



6 -ed sex "[ec sex lookup [civ sex]]" 



14 ! linus: di -pg 1 
18 04/29/83 
20 NAME I JOB 



Sample Report 



abel 

abell 

a<MORE> 



SALARY 



$14,555.01 
$13,000.01 
$12,500.01 



10:26 



(45 data lines) 
azer | 5 i $12,600.01 



AGE 


1 SEX 


1 F 


STATE 


1 CITY 






1 A 










i M 










1 I 










1 L 










I Y 






36 


1 male 


1 s 


ak 


juneau 


55 


1 female 


m 


az 


phoenix 


61 


1 male 


; d 


ca 


fresno 


44 


1 male 


1 s 


va 


norfork 



- Page 1 - 



line 1 

Set the width of the sex column to "6" from its previous default value 
of "1," and prepare for special editing of the sex column data. 

line 3-12 

Invoke the ted editor, append the following exec_com data (line 5-9) 
into the ted buffer, terminate append mode, write the buffer to permanent 
storage, and quit the ted editor. 

line 14 

Display page 1 

line 18-77 

System display — note the change in width of the sex column (line 20) 
from that displayed in the previous example (line 189) and the change of 
data by the exec_com (m = male and f = female). 
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SAVING A REPORT AND RESETTING OPTIONS 



The following example shows how to save a report after it is in the desired 
format. Additionally, the example shows how to reset all options and revert the 
report back to its original format. 



1 ! 

5 



1 inus : 
name 



svfo EXAMPLE-1 . fo .lec -query;sfo -rs;-di -pg 1 



job 



salary 



age 



St 

at 
e 



city 



64 



abel 


1 


14555. 


01 


36 


m 


s 


ak 


juneau 


abell 


2 


13000. 


01 


55 


f 


m 


az 


phoenix 


abernathy 


3 


12500. 


01 


61 


m 


d 


ca 


f resno 


abodoura 


5 


12900. 


01 


61 


m 


m 


ca 


Sacramento 


aboe 


4 


10201. 


01 


41 


f 


s 


ca 


los angeles 


abraham 


6 


15000. 


01 


25 


f 


d 


ca 


san diego 


. (46 data 


lines) 
















baker 


1 


12000. 


10 


71 


m 


s 


il 


Springfield 



line 1 

Save the current values of format options as a linus subsystem exec__com 
(EXAMPLE-1 . fo .lec) which can be restored later with the 
r estore_format_options request. Then reset all options to their default 
values, and display page 1. 

line 5-64 

System display — note that the report has reverted back to its original 
format (i.e., it is now the same as the first example in this sample user 
session) . 

At this point you may wish to terminate the linus session by entering: 

65 ! linus: q 

66 (Nultics ready message) 



8/86 
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RESTORING A SAVED REPORT 



The report saved in the previous example may be recalled at will. Assuming you 
want to have the report printed, then the following sequence of events must be set up: 



linus 
linus : 
linus : 
linus : 
linus : 



o employer r 
ss employee r u 
rsfo EXAMPLE-1 .fo.lec 
di -nr -pg 1 











OcilU p J. c 










NAME 1 


JOB i 


SALARY 


! AGE 


1 SEX 


1 F 
! A 
M 
I 


STATE 


1 CITY 


abel 1 


1 1 


$14,555. 


01 


1 36 


1 male 


L 
Y 

s 


ak 


1 juneau 


abell 1 


2 1 


$13, 000. 


01 


! 55 


i female 


m 


az 


1 phoenix 


a<MORE> 1 


3 ! 


$12, 500. 


01 


! 61 


! male 


1 d 


ca 


fresno 


a<MORE> 1 


5 i 


$12, 900. 


01 


1 61 


1 male 


1 m 


ca 


Sacramento 


aboe ! 


4 1 


$10,201. 


01 


1 41 


1 female 


s 


ca 


los angeles 


. (43 data 


lines) 
















azer ! 


5 1 


$12,600. 


01 


i 44 


1 male 


! s 


va 


norfork 



69 



- Page 1 - 



71 ! linus: di -of example-1 



line 1-4 

Set up for restoring the saved format options, 
line 5 

Display page 1 of the report as a verification (i.e., is this the desired 
report?) . 

line 9-69 

System display — note that the report is restored to its original condition 
(i.e., restored to the same format as that shown in the example under "Special 
Editing of a Report" above). 

line 71 

Write the complete formatted report to permanent storage in the user's 
working directory with pathname of "example-1". 

The full report (example-1), along with the saved format options segment 
(EXAMPLE-1 . fo .lec) now resides in the user • s working directory and may be printed or 
retained in permanent storage at the user's discretion. 
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General Column Options 



The following examples look at the "general column options." These options 
remain in effect only for the duration of the current query. Every time a new 
query is performed, new default values are assigned. The options are listed 
(through use of the list_format options request) when their value is different 
from the default, or when asked Tor by name. 



1 ! linus: 
2 



4 ! 



Isfo -co 



-column_order 


"name 


Job salary age sex 


family 


state city" 


linus: sfo 


-co 8 7 1 


2 3 4 5 6;di 


-Pg 1 








04/29/83 




Sample Report 




10:28 


CITY 


1 STATE 


1 NAME 1 


JOB 1 


SALARY 


! AGE 


j SEX 1 F 
I ! A 
1 i M 
1 1 I 


Juneau 

phoenix 

fresno 


{ ak 
1 az 
! ca 


1 abel 1 
i abell 1 
1 a<MORE> 1 


1 i 

2 1 

3 ! 


$14,555.01 
$13,000.01 
$12,500.01 


36 

j 55 
1 61 


1 1 L 
i ! Y 

1 male | s 
1 female | m 
1 male ! d 


. (45 data 


lines) 












norfork 


1 va 


! azer ! 


5 1 


$12,600.01 


i 44 


1 male | s 



67 



- Page 1 - 



line 1 

List the current names and order of the report columns, 
line 4 

Reorder the sequence of report columns and display page 1. 
line 8-67 

System display — note that the column order has been changed from that 
displayed in the previous example. 



Even though the columns are re-ordered (line 4 above), the user must still set 
and list them in the query order sequence. For example: 

69 ! linus: sfo -wid 8 -default ;lsfo -wid 8 
-width city "13" 



Although city appears on the page first (i.e,, left column in above example), 
the column is still column 8. 

71 ! linus: sfo -co 7 8; Isfo -co 

72 -column order "state city name job salary age sex family" 



Notice that all columns were not named in the -column_order request above (line 
71) and that the system defaults all names (line 72). Future displays of the 
report will have the columns reordered to 78123456 until changed by the 
user . 
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74 ! linus: Isfo -ex 

75 -exclude "" 

77 ! linus: sfo -ex age job;di -pg 1 



81 



04/29/83 
STATE 



ak 
az 
ca 



CITY 



juneau 
phoenix 
f resno 



(45 data lines) 
va I norfork 



Sample Report 

NAME I SALARY 



abel 

abell 

a<MORE> 



azer 



$14,555.01 
$1 3, 000. 01 
$12,500.01 



SEX 



10; 31 

F 
A 
M 
I 
L 
Y 



male 

female 

male 



I $12,600.01 \ male 



140 



- Page 1 - 



line 74 

List columns currently excluded from the report, 
line 75 

System display — the response is "", meaning that no columns are currently 
excluded . 
line 77 

Exclude the age and job columns and display page 1. 
line 81-140 

System display — note that the age and job columns have been excluded 
from the report (i.e., the report now consists of six columns of data 
instead of the eight previously included). 



142 ! linus: sfo -ex "";lsfo -ex 

143 -exclude 



Execution of line 142 restores the age and job columns previously excluded by 
execution of line 77. Line 143 is the system display indicating that no columns 
are currently excluded. 
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The next few examples look at the "group" option which is used in conjunction 
with other requests. This option is used to define a "group" of rows based on 
the content of one or more columns. 



145 1 linus: Isfo -gr 

146 -group "" 

148 ! linus: sfo -gr state city sex; Isfo -out 

149 -outline "" 

151 ! linus: sfo -out sex;di -sort state city sex -pg 1,2 
155 04/29/83 Sample Report 



10:33 



STATE 


CITY 


NAME 


JOB 


SALARY 


AGE 


SEX 


ak 


juneau 


bambry 


10 


$1 1 , 501. 01 


66 


female 






gaskins 


6 


$14, TOO. 01 


31 








Justin 


2 


$12, 000. 01 


78 




! (16 


data lines) 












az 


phoenix 


abell 


2 


$1 3. 000. 01 


55 


female 






c<MORE> 


22 


$18,300. 01 


38 








June 


18 


$10, 900. 01 


73 




! (12 


data lines) 














tucson 


monaco 


20 


$12, 300.01 


30 


female 






nevitte 


15 


$12, 300.01 


77 








pauley 


10 


$11,600.01 


56 








n<MORE> 


5 


$12,il00,01 


57 


male 






ordeman 


1 


$15, 200.01 


21 




ca 


fresno 


bane 


13 


$15,200.01 


50 


female 


(6 data lines) 
















a<MORE> 


3 


$12, 500. 01 


61 


male 






c<MORE> 


23 


$12, 400. 01 


53 








jupiter 


19 


$ 4, 100. 01 


47 





214 



- Page 1 - 
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This ends the first page of the report (refer to line 151 that set up a two-page 
display). The second page of the report immediately follows the commentary 
describing the setup for page 1. 

line U5 

List the columns currently set for grouping purposes, 
line 146 

System display — no current grouping set. 
line 148 

Set grouping for columns (state, city, and sex), and list the columns 
currently set as candidates for duplicate suppression. 

line 149 

System, display — no current outline set. 
line 151 

Set the outline column value to "sex." The outline option is used to 
suppress duplicate columns. Outlining is done when the value of a column 
is the same for the current row as it is on the previous row. Outlining 
is never done when it is the first row of a new page. The example sets 
outlining for the sex column. The sex column is the most minor column 
in the group and therefore all columns more major have outlining done 
also. The second request on the line invokes display (with sort) of 
pages 1 and 2. First the data has to be sorted so that use of this 
option can be further described in later examples. 

The following example is page 2 of the report invoked by the second request on 
line 151. 



04/29/83 



Sample Report 



10:33 



STATE 


CITY 


NAME 


JOB 


SALARY 


AGE 1 


ca 


fresno 


Iceland 


14 


$32, 800. 01 


77 






m<MORE> 


9 


$10, 200. 01 


32 1 






mcclung 


5 


$13, 100. 01 


71 ! 






ra<MORE> 


1 


$14, 100.01 


26 






monger 


21 


$12, 600. 01 


61 1 




los angeles 


aboe 


4 


$10,201.01 


41 1 



SEX 



male 



female 



(37 data lines) 



san diego 



abraham 


1 6 


$15,000.01 


25 


female | d 


c<M0RE> 


2 


$13,000.01 


44 


! s 


kang 


22 


$19, 201. 01 


23 


1 m 


levy 


1 18 


$10, 800.01 


66 


! d 


m<MORE> 


1 13 


$14, 800. 01 


71 


1 s 


mccrary 


8 


$13,000.01 


25 


1 m 




Page 2 ■ 
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Sorting is done external to MRDS. The values must all be retrieved before 
sorting can be done. When display is invoked without control arguments, the 
system defaults to a new retrieve on each invocation. The next two examples 
show how this retrieve can be kept and then recalled. 



216 ! linus: di -sort state city sex -kr -pg 2 
220 04/29/83 Sample Report 

STATE 



ca 



234 



1 CITY 


NAME 


JOB 


SALARY 


AGE 


fresno 


Iceland 


14 


$32, 800. 01 


77 




m<MORE> 


9 


$10, 200, 01 


32 




mcclung 


5 


$13, 100. 01 


71 




m<MORE> 


1 


$14, 100. 01 


26 




monger 


21 


$12, 600. 01 


61 


1 los angeles 


aboe 


4 


$10, 201. 01 


41 


data lines) 










sen diego 


abraham 


6 


' $15,000.01 


25 




c<MORE> 


2 


$13, 000. 01 


44 




kang 


22 


$1 9, 201. 01 


23 




levy 


18 


$10, 800. 01 


66 




m<MORE> 


13 


$14, 800. 01 


71 




mccrary 


8 


' $13,000.01 


25 



10: 34 



SEX 



male 



female 



f emale 



279 



- Page 2 - 



line 216 

Sort the state, city, and sex columns; then display page 2. In addition, 
keep the results of the retrieve. 

line 220 - 279 

System display. 

The sorted data is now retained for future use (see -kr on line 216). Future 
display requests may now re-call the kept data (i.e., the amount of system time 
required after execution of line 216 until the report is displayed can be minimized 
in future displays). 

281 ! linus: di -kr -or -pg 2 



The display results (provided by execution of line 281) would be an exact copy 
of that provided in line 220-279 above, except that the time required to produce 
the report is less. 
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Outlining can also be done on columns which are not a member of the group, 
example : 



283 ! linus: Isfo -out 
-outline 

286 I linus: sfo -out sex family 
288 ! linus: di -kr -or -pg 1,2 



'sex" 



292 04/29/83 
STATE 



ak 



CITY 



juneau 



( 1 6 data lines) 
phoenix 



az 



( 1 2 data lines) 



NAME 



Sample Report 



JOB 



bambry 

gaskins 

Justin 



abell 

c<MORE> 

June 



10 
6 
2 



SALARY 



$11,501.01 
$14,700.01 
$12,000.01 



2 I $13,000.01 
22 I $18, 300.01 
18 I $10,900.01 



For 



AGE 



66 
31 
78 



55 
38 
73 



10: 36 



SEX 



female 



female 



338 



ca 



! tucson 


monaco | 


20 


$12, 300. 


01 


30 


female 




nevitte | 


15 


$12, 300. 


01 


77 






Pauley I 


10 


$1 1 , 600. 


01 


56 






n<MORE> i 


5 


$12, 400. 


01 


57 


male 




ordeman | 


1 


$15,200. 


01 


21 




1 fresno 


bane ! 


13 


$15, 200. 


01 


50 


f emale 


data lines) 
















a<MORE> 1 


3 


$12, 500. 


01 


61 


male 




MODI? V 1 




A -1 o II rvi-1 


r\ 1 
U 1 


cr o 
"J J 






jupiter 1 


19 


$ 4, 100. 


01 


47 





351 



- Page 1 - 



line 283 

List the columns currently set as candidates for duplicate suppression, 
line 286 

Set the outline column value to "sex" and "family." (Refer to additional 
description regarding outlining in the commentary of line 151 above.) 

line 288 

Display page 1 and 2 using the data retrieved during the previous invocation 
(-or), and keep the retrieved data (-kr) from this execution for use in 
subsequent invocations of the display request. 

line 292-351 

System display — note the family entry for line 338 is blank indicating 
duplicate suppression of "m" which would normally have displayed (see 
line 201 above). 

Page 2 of the report is not shown. 



4-41 



AZ49-03 



This page intentionally left blank. 



4-42 



The size of a retrieved table can cause a process directory quota overflow when working 
with large tables . The -temp_dir control argument for the display request allows the 
user to provide a directory for the retrieved table where enough quota is available. 
The -temp_dir argument can only be used when requesting a new table. 



353 ! linus: di -or -kr -td Ce wd] -pg 1 

354 linus ( display) : Warning: The temp__dir >udd>Demo>linus_test won ' t be used . 



line 353 

Display page 1 using the data retrieved during the previous invocation C-or) 
and keep the retrieved data (-kr) from this execution, utilizing the 
temporary directory "wd". 

line 354 

System display warning message because a new retrieval was not requested 
(i.e., -old retrieval was used). 

Page 1 of the report is not shown . It would be an exact duplicate of that shown in line 
292-351 above, if it were included here. 



356 ! linus: di -kr -td [e wd] -pg 1 -sort state city sex 
line 356 

Display page 1 using a new retrieval, keep the retrieved data for future use, 
and utilize "wd" for a temporary directory. 

Page 1 of the report is not shown . It would be an exact dupl ica te of that shown in 1 ine 
292-351 above, if it were included here. 



To verify that the working directory (wd) was in fact used for the temporary directory, 
enter : 



358 ! linus: ., 

359 Segments 
360 

361 rew 0 



Is 

: 224, Length = 353 
! BBB JNHFGn QJX 1w . temp . 0565 



369 r w 0 !BBBJNHFGmXFcFB. LINUS. table 

370 r w 1 EXAMPLE-1.fo.lec 

371 r w 1 sex__lookup .lec 



line 358 

Escape out of linus and list the current contents of the working directory, 
line 359-371 

System display — lines 359-369 outlines the areas used for the temporary 
directory. Note that line 370 is associated with an earlier example where the 
contents of a report was saved (refer to "Saving a Report and Resetting 
Options") and line 371 identifies the segment which contains the exec_cora 
used to change "m" and "f" to "male" and "female" for the sex column (refer to 
"Special Editing of a Report"). 



8/86 



4-43 



AZ49-03A 



375 ! linus: Isfo -pb 

376 -page break 



itn 



378 ! linus: sfo -pb state ;di -kr -or -pg 1,^1 



Line 375 is a request to list the current columns that are candidates for new 
page breaks and line 376 says there are no current candidates. The following 
four examples show full-page representations of the results of the requests in 
line 378 (set page break value to "state" and display pages 1 through 4). 



AZ49-03 



04/29/83 
STATE 



CITY 



ak 



juneau 



NAME 



Sample Report 



JOB 



SALARY 



bambry I 


1 0 


1 $11, 


50 1 . 


01 1 


66 


female 


1 d 


gaskins 1 


6 


1 $14, 


700. 


01 ! 


31 




1 s 


justin 1 


2 


1 $12, 


000 . 


01 1 


78 




! m 


macleod i 


22 


1 $18, 


500. 


01 1 


43 




1 d 


manuel 1 


1 8 


! $10, 


000. 


01 1 


33 




1 s 




1 


4 1 11 


yuu . 


U 1 1 


AT 
0 / 




1 m 


m<MORE> 1 


8 


1 $13, 


000. 


01 1 


77 




1 d 


nesline 1 


4 


1 $10, 


100. 


01 1 


27 




1 s 


ord 1 


24 


! $ 9, 


200. 


01 I 


34 




i m 


abel i 


1 


1 $14, 


555, 


01 1 


36 


male 


1 s 


cooke i 


21 


1 $12, 


100. 


01 i 


34 




1 m 


jones 1 


16 


! $13, 


000. 


01 1 


21 




1 d 


ledger i 


1 1 


1 $21, 


900. 


01 I 


27 




1 s 


tnaclure 1 


7 


! $14, 


700. 


01 1 


53 




1 m 


m<MORE> i 


3 


1 $12, 


100. 


01 I 


71 




1 d 


mead ! 


23 


1 $12, 


700. 


01 1 


29 




1 s 


molloy ! 


19 


! $ 4, 


300. 


01 ! 


22 




1 m 


nevling j 


14 


! $32, 


500. 


01 1 


63 




1 d 


paul I 


9 


1 $10, 


300. 


01 1 


73 




1 s 



AGE 



SEX 



10: 39 
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4-45 



AZ49-03A 



04/29/83 
STATE 



Sample Report 



10:40 



CITY 



az 



phoenix 



tucson 



NAME ! 

[ 


JOB 


SALARY i 


AGE 


1 SEX 


[ 
j 

abell ! 


2 


$1 3j 


000. 01 I 


55 


1 female 




22 


$1 8, 


300. 01 1 


o o 
3o 




June 1 


i o 

1 8 


$10, 


AAA A I 1 

900 . 0 1 1 


73 




lednar | 


1 3 


$ 1 D> 


(JUL) . U 1 1 


1 1 






o 
o 


* -1 o 

$ 1 ^, 


OUO . U 1 1 


37 




— ✓ MAD I? S. 1 

m<MURE> 1 




$10, 


O A A A 1 1 

oOO .01 1 


£ o 
Do 




meadow i 


II 

24 


$ 9, 


800. 0 1 1 


52 


1 • 


bander | 


1 1 


$21 , 


100.01 1 


70 


1 male 


gelst 1 


7 


$1 4, 


600. 01 i 


21 




kane I 


3 


$1 2, 


300.01 1 


58 




maclin | 


23 


i 1 5 


CAA A I 1 
DUU . U 1 1 


79 




manzo ! 


1 9 


$ 4, 


200.01 1 


T ll 

74 




mccoy 1 


1 ii 
1 4 


$31, 


300.01 1 


67 




raeagher | 


9 


$10, 


500.01 1 


52 




U UpU X S 1 


1 0 


$12, 


000.00 1 


2ft 
0 




monaco I 


20 


$12, 


300.01 1 


30 


1 female 


nevitte | 


15 


$12, 


300.01 1 


77 




Pauley i 


10 


$1 1 , 


600.01 1 


56 




n<MORE> ! 


5 


$12, 


400.01 1 


57 


1 male 


ordeman | 


1 


$15, 


200.01 1 


21 





- Page 2 - 



4-46 



AZ49-03 



04/29/83 
STATE 



CITY 



ca 



f resno 



los angeles 



Sacramento 



NAME 



Sample Report 



JOB 



10: 40 



SALARY 



bane | 


13 


$15, 


200. 


01 1 


50 


george I 


8 


$12, 


100. 


01 1 


44 


kang I 


4 


$10, 


000. 


01 ! 


76 


maclure | 


24 


$ 9, 


700. 


01 [ 


47 


marcey 1 


20 


$12, 


600. 


01 ! 


71 


mccrary ' 


15 


$1 2, 


500. 


01 1 


53 


raeakin I 


10 


$1 1 , 


600. 


01 1 


51 


a<MORE> 1 


3 


$1 2, 


500. 


01 j 


61 


c<MORE> 1 


23 


$12, 


400. 


01 i 


53 


jupiter 1 


19 


$ 4, 


100. 


01 I 


47 


leeland | 


14 


$32, 


800. 


01 1 


77 


m<MORE> 1 


9 


$10, 


200. 


01 1 


32 


mcclung i 


5 


$13, 


100. 


01 I 


71 


m<MORE> i 


1 


$14, 


100. 


01 ! 


26 


monger i 


21 


$12, 


600. 


01 1 


61 


aboe 1 


4 


$10, 


201 . 


01 ! 


41 


cowes 1 


24 


$ 9, 


500. 


01 J 


58 


Justin i 


20 


$1 2, 


900. 


01 1 


34 


leestma I 


15 


$1 2, 


300. 


01 1 


69 


ra<MORE> 1 


10 


$1 1 , 


400. 


01 I 


52 


m<MORE> 1 


6 


$15, 


000. 


01 1 


26 


meagher i 


2 


$1 2, 


600. 


01 I 


67 


monroe i 


22 


$1 8, 


900. 


01 I 


42 


newhall | 


1 8 


$10, 


000. 


01 1 


30 


pavlov i 


13 


$14, 


000. 


01 i 


24 


barker I 


14 


$32, 


800. 


01 1 


78 


g<MORE> 1 


9 


$10, 


900. 


01 ! 


45 


katz I 


5 


$1 2, 


400. 


01 i 


70 


m<MORE> 1 


1 


$14, 


800. 


01 ! 


57 


marcus | 


21 


$1 2, 


600. 


01 1 


62 


mccory [ 


16 


$1 2, 


700. 


01 I 


54 


mealey | 


1 1 


$21 , 


600. 


01 ! 


36 


nevitte I 


T 


$14, 


900. 


01 ! 


39 


orf j 


3 


$12, 


400. 


01 i 


70 


barrett i 


15 


$12, 


800. 


01 1 


65 


gill I 


10 


$1 1 , 


800. 


01 1 


47 


keene j 


6 


$14, 


100. 


01 1 


54 


m<MORE> 1 


2 


$12, 


200. 


01 1 


IT ll 

54 


raarcy | 


22 


$19, 


700. 


01 ! 


45 


m<MORE> 1 


18 


$10, 


900. 


01 ! 


62 


means I 


13 


$14, 


300. 


01 1 


46 


newcomb I 


8 


$12, 


300. 


01 i 


36 


orlaens i 


4 


$10, 


300. 


01 ! 


41 


a<MORE> 1 


5 


$12, 


900. 


01 1 


61 


c<MORE> 1 


1 


$14, 


300. 


01 1 


50 


kane [ 


21 


$12, 


400. 


01 ! 


24 


leonard 1 


16 


$12, 


900. 


01 I 


25 


raacnabb ! 


1 1 


$21, 


500. 


01 i 


68 


mccoy ! 


7 


$14, 


000. 


01 1 


77 



AGE 



SEX 



female 



male 



female 



male 



female 



male 
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This page intentionally left blank. 
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AZ49 



04/29/83 
STATE 



Sample Report 



CITY 



ca 



Sacramento 



san diego 



san francisco 



santa cruz 



NAME 1 
1 


JOB 


SALARY 


AGE 


1 
1 

raeakin | 


3 


$12, 


900. 01 


71 


monson | 


23 


$13, 


000. 01 


40 


newman | 


19 


$ 4, 


200. 01 


68 


payne | 


14 


$30, 


400. 01 


30 


abraham i 


6 


$15, 


000. 01 


25 


c<MORE> 1 


2 


$13, 


000. 01 


44 


kang I 


22 


$19, 


201. 01 


23 


levy 1 


18 


$10, 


800. 01 


66 


m<MORE> 1 


13 


$14, 


800. 01 


71 


mccrary | 


8 


$13, 


000. 01 


25 


mealey | 


4 


$10, 


700. 01 


71 


montano | 


24 


$ 9, 


300. 01 


22 


newton | 


20 


$13, 


100. 01 


24 


peacock | 


15 


$12, 


500. 01 


76 


b<MORE> 1 


16 


$12, 


310. 01 


63 


keener | 


7 


$14, 


000. 01 


62 


m<MORE> i 


3 


$12, 


400. 01 


63 


m<MORE> 1 


23 


$12, 


600. 01 


38 


m<MORE> 1 


19 


$ 4, 


000. 01 


22 


mecham I 


14 


$30, 


400. 01 


23 


newhall | 


9 


$10, 


300. 01 


21 


o<MORE> 1 


5 


$12, 


900. 01 


27 


baur 1 


18 


$10, 


100. 01 


79 


gnandt i 


13 


$14, 


700. 01 


60 


kelly 1 


8 


$12, 


410. 01 


25 


macnabb | 


4 


$10, 


100. 01 


68 


markle | 


24 


$ 9, 


100. 01 


75 


rn<MORE> | 


20 


$12, 


900. 01 


23 


media I 


15 


$12, 


300. 01 


45 


newman I 


10 


$1 1 , 


300. 01 


62 


orrison I 


6 


$14, 


100. 01 


30 


abrahms j 


7 


A 1 ii 

^) 1 H , 


^ r\ r\ r\ A 
U 1 


35 


c<MORE> 1 


3 


$12, 


501. 01 


76 


katz 1 


23 


$12, 


500. 01 


58 


libin 1 


19 


$ 4, 


000. 01 


29 


macnair | 


14 


$31, 


300. 01 


70 


mccory I 


9 


$10, 


500. 01 


52 


means | 


5 


$12, 


900. 01 


60 


monte | 


1 


$15, 


300. 01 


31 


nguyen | 


21 


$12, 


700. 01 


53 


parce i 


16 


$12, 


900. 01 


68 


nevling | 


6 


$14, 


400. 01 


37 


orend | 


2 


$12, 


900. 01 


72 


newcomb I 


16 


$12, 


400. 01 


72 


paulson 1 


11 


$21, 


100. 01 


49 



SEX 



male 



f emale 



male 



female 



10: 40 

F 
A 
M 
I 

L 
Y 



f emale 
male 
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Now we will experiment with column subtotals and totals. A subtotal specification 
is given in the form of one or more "triplets." A triplet is given as the 
column to be subtotaled, followed by the column whose value change should generate 
the subtotal, and optionally followed by "reset" or "running" to indicate what 
type of subtotal is desired. Reset is the default. In the following example, 
line numbers 1-8 are intentionally left blank. 



9 ! linus: sfo -rhv "" -rfv "" 

11 ! linus: Isfo -stt 

12 -subtotal "" 

14 ! linus: sfo -stt salary , state , reset 



The subtotal inherits its width, editing request, etc. from the parent column. 
The width of the salary column must be increased or the subtotal will be folded, 
and a larger picture is needed to edit it through. The age and job columns are 
left at their present width so the filling of numbers can be seen later when the 
numbers become large enough. 



16 ! linus: Isfo -wid salary 

17 -width salary 

19 ! linus: sfo -wid salary 14 

21 ! linus: Isfo -ed salary 

22 -editing salary 



I1 10" 



"[pic $zz,zz9v.99 [civ salary]]" 



24 ! linus: sfo -ed salary "[pic $zz , zzz , zz 9v . 99 [civ salary]]" 

26 ! linus: Isfo -al salary 

27 -alignment salary "decimal 8" 

29 ! linus: sfo -al salary decimal 12 

31 ! linus: di -nr -kr -sort state city sex -pg 1,4 



35 



04/29/83 
STATE 



ak 



CITY 



juneau 



NAME 



Sample Report 



JOB 



(15 rows of data) 

64 ak 

(30 blank lines) 

95 



bambry 

gaskins 

Justin 



paul 



10 
6 
2 



SALARY 



1 1 , 501. 01 
14, 700. 01 

12, 000. 01 



$ 10,300.01 
$ 262,056.19 



AGE 



66 
31 
78 



73 



SEX 



10: 42 

F 
A 
M 
I 
L 
Y 



f emale 



- Page 1 - 



4-50 



AZ49-03 



line 9 

Set row header and row footer values to "default." 
line 11-14 

List current value for subtotal, and set up new value, 
line 16-29 

List current value for width, editing, and alignment of the salary column, 
and set up new values. 

line 31 

Display pages 1 through 4 of the report, starting with a new retrieval, 
sorting the report as indicated to get back into the full format ^ and 
keep the retrieval for re-use. 

line 35-281 

System display — note the inclusion of subtotals in the salary column 
(total by state — see line 64, 127, and 276). The remaining three 
pages of the report follow. 



97 04/29/83 

STATE I CITY 



Sample Report 



10:42 



az 



phoenix 



( 13 rows of data) 
tucson 



127 az 

(31 blank lines) 

157 



NAME 1 


JOB 




SALARY 1 


AGE 


abell ! 


2 


I $ 


13, 000. 01 1 


55 


c<MORE> 1 


22 


I $ 


18,300.01 1 


38 


monaco ! 


20 


1 $ 


12,300.01 I 


30 


nevitte 1 


15 


! $ 


12,300.01 1 


77 


Pauley j 


10 


! $ 


11,600.01 i 


56 


n<MORE> i 


5 


; $ 


12,400.01 1 


57 


ordeman | 


1 


1 $ 


15,200.01 1 


21 






I $ 


272,700.19 1 






- Page 


2 - 







SEX 



female 



female 



male 
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This page intentionally left blank. 
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AZ49 



159 04/29/83 
STATE 



CITY 



ca 1 fresno 

( 1 3 rows of data) 

! los angeles 
j 

( 17 rows of data) 

I Sacramento 
I 
I 

( 12 rows of data) 



Sample Report 
NAME I JOB 1 SALARY 



bane 
george 



aboe 
cowes 



barrett 
gill 



I mccoy 



13 



4 
24 



15 
10 



219 



7 I $ 
- Page 3 - 



15,200.01 I 
12,100.01 i 



10,201.01 I 
9,500.01 I 



12,800.01 ! 
11,800.01 I 



14,000.01 



AGE 



50 
44 



41 
58 



65 I 
47 i 



77 



SEX 



10: 42 

I F 

I A 

1 M 

I I 

I L 

! Y 



female 



female 



female 



I m 



I s 
I m 



221 



04/29/83 
STATE 



ca 



CITY 



NAME 



Sample Report 



JOB 



SALARY 



i Sacramento 


meakin i 


3 


$ 


12, 900. 


01 i 


71 


male 


i m 




! monson [ 


23 


$ 


13, 000, 


01 I 


40 




1 d 




! newman 1 


19 


$ 


4, 200. 


01 I 


68 




; s 




1 payne | 


14 


$ 


30, 400. 


01 1 


30 




1 m 


1 san diego 


abraham | 


6 


$ 


15, 000. 


01 1 


25 


female 


d 




1 c<MORE> 1 


2 


$ 


13,000. 


01 i 


44 




1 s 


( 16 rows of data) 


















1 san franclsco 


baur i 


18 


$ 


10, 100. 


01 i 


79 


female 


d 




gnandt | 


13 


$ 


14,700. 


01 i 


60 




' s 



AGE 



( 17 rows of data) 





1 santa cruz 


1 nevling | 
i orend | 
1 newcomb | 
j paulson 1 


6 ! $ 
2 1 $ 
16 j $ 
11 I $ 


276 


ca ! 

• 

(4 blank lines) 

• 




1 .$ 


281 






- Page 4 - 



14,400.01 
12,900.01 
12,400.01 
21, 100.01 



$ 1,302,223.95 



SEX 



10:43 

1 F 

I A 

! M 

I I 

I L 

I Y 



37 
72 
72 
49 



female 
male 



4-53 



AZ49-03 



The following example shows how to get subtotals for multiple columns in addition to more 
than one subtotal per column. 



11 



30 



43 

46 
49 



! linus: sfo -stt -prompt 
Enter -subtotal. 

! age, sex salary, sex job, sex age, city salary, city job, city age, state 
! salary, state job, state 



7 ! linus: di -or -kr -pg 1,3 
04/29/83 



Sample Report 



STATE i CITY 
1 
1 
1 


NAME 


JOB 




SALARY 


AGE 


1 
! 

ak 1 juneau 


bambry 


10 


$ 


1 1, 501. 01 


66 


1 


gaskins 


6 


$ 


14, 700. 01 


31 


I 


justin 


2 


$ 


12, 000. 01 


78 




macleod 


22 


$ 


1 8, 500. 01 


43 




manuel 


18 


$ 


10, 000. 01 


33 




m<MORE> 


13 


$ 


14, 900. 01 


67 




ro<MORE> 


8 


$ 


1 3, 000. 01 


77 




nesline 


4 


$ 


10, 100.01 


27 


1 


ord 


24 


$ 


9, 200. 01 


34 






107 


$ 


1 1 3 , 90 1 . 09 


456 




abel 


1 


$ 


14,555.01 


36 




cooke 


21 


$ 


12, 100.01 


34 




jones 


16 


$ 


13, 000. 01 


21 




ledger 


11 


$ 


21 , 900. 01 


27 




maclur e 


7 


$ 


14, 700. 01 


53 




m<MORE> 


3 


$ 


12,100.01 


71 




mead 


23 


$ 


12, 700. 01 


29 




molloy 


19 


$ 


4, 300. 01 


22 




nevl ing 


14 


$ 


32,500.01 


63 




paul 


9 


$ 


10, 300.01 


73 


ak 1 juneau 




124 


$ 


148, 155. 10 


429 


ak 1 juneau 




231 


$ 


262, 056. 19 


885 


ak ; 




231 


$ 


262,056. 19 


885 



SEX 



10; 43 

F 
A 
M 
I 
L 
Y 



female 



female 



male 



male 



(22 blank lines) 



71 
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line 1 

Request to set columns for subtotal ing, with prompt, 
line 2 

System display — prompt, 
line 3-5 

Set column values to be subtotaled, and terminate the prompt 



8/86 



4-54 



AZ49-03A 



line 7 

Display pages 1 through 3- 
line 11-195 

System display — the display of pages 2-3 follow. 



73 04/29/83 
STATE 



Sample Report 



10: 43 



az 



az 



az 



az 



CITY 


1 NAME I 
} 1 

1 i 


JOB 




SALARY 1 


AGE 




1 1 

1 abell 1 


2 


$ 


13,000.01 1 


55 


1 c<MORE> 1 


22 


$ 


18,300.01 ! 


38 




i June 1 


1 8 


$ 


10,900.01 1 


73 




1 lednar 1 


13 


$ 


15,000.01 1 


71 




! tn<MORE> i 


8 


$ 


12,600.01 1 


37 




1 m<MORE> i 


4 


$ 


10,800.01 1 


68 




1 meadow ! 


24 


$ 


9,800.01 1 


52 




i j 

' ' 


91 




90,400.07 1 


394 




1 bander 1 


1 1 


$ 


21,100.01 I 


70 




1 geist 1 


7 


$ 


14,600.01 1 


21 




1 kane 1 


3 


$ 


12,300.01 i 


58 




1 maclin ! 


23 


$ 


12,500.01 ! 


79 




I tn an zo i 


1 Q 






74 




1 mccoy 1 


14 


$ 


31,300.01 i 


67 




i meagher 1 


9 


$ 


10,500.01 { 


52 




! dupuis I 


12 


$ 


12,000.00 I 


28 


phoenix 




98 


$ 


118, 500.07 1 


449 


phoenix 




189 


$ 


208,900.14 j 


843 


tucson 


! menace 1 


20 


$ 


12,300.01 1 


30 




1 nevitte i 


15 


$ 


12,300.01 i 


77 




! pauley 1 


10 


$ 


11,600.01 1 


56 






45 


$ 


36,200.03 1 


163 




1 n<MORE> 1 


5 


$ 


12,400.01 1 


57 




1 ordeman i 


1 


$ 


15,200.01 1 


21 


tucson 




6 


$ 


27, 60.02 i 


78 


tucson 




51 


$ 


63,800.05 1 


241 






240 


$ 


272,700.19 1 


1084 



SEX 



female 



female 



male 



male 

female 

female 
male 

male 



. (10 blank lines) 



133 
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135 04/29/83 



Sample Report 



10: 44 



STATE 



ca 



CITY 



fresno 



fr esno 

fresno 

los angeles 



NAME i 
I 


JOB 




SALARY 1 


AGE 


! 

[ 
' 

t)3 n e 1 


1 7. 


! ^ 


15, 


200.01 i 


DU 


george ! 


8 


! $ 


1 o 

1 


i A A A 1 1 

100.01 1 


44 


kang ! 


4 


I $ 


1 U , 


AAA A 1 1 

UUU. U 1 1 


76 


maclure 1 


24 


! $ 


Q 
J 1 


7An ni 1 
1 UU . U 1 1 


47 


marcey 1 


20 


! $ 


1 o 
1 <1 , 


<^ A A A 1 1 
OUU . U 1 1 


71 


niccrary i 


1 c; 
1 0 


> <fe 
1 "P 




CA A A 1 1 


0 5 


lUCdKXn 1 


in 


* 


i i 
1 1 , 


AAA A1 i 
OUU . U 1 1 


1 


{ 


Oil 


1 $ 


83, 


700.07 1 






•3 

J 


1 «P 


12, 


500.01 j 


A 1 
0 1 




o o 
<i5 




12, 


400.01 1 


53 


jupiter ! 


19 


. $ 


4, 


100.01 1 


47 


leeland I 


14 


$ 


32, 


800.01 i 


77 


m<MORE> 1 


9 


$ 


10, 


200.01 1 


32 


mcclung 1 


5 


' $ 


13, 


100. 01 1 


71 


m<MORE> 1 


1 


. $ 


1 *t , 


1 A A A 1 1 

lUO. 01 1 


26 


monger I 


21 


$ 


1 o 
1 ^, 


AAA A1 1 

OUU. Ul 1 


61 








111, 


800.08 1 


Jl O Q 


} 


1 fio 

1 oy 


1 $ 


1 95, 


500. 15 1 


Q O A 


1 

aboe 1 


ii 


1 9 


10, 


20 1 . 0 1 i 


4 1 


cowes 1 


on 


* 


9, 


500.01 1 


DO 


Justin 1 




* 


12, 


900.01 1 




leestma i 


1 

1 J 




12, 


300.01 1 


AO 


m<MORE> 1 


10 


$ 


1 1 1 


lino f\ ^ 1 

400.01 1 


52 


m<MORE> 1 


6 


. $ 


Id , 


AAA A1 1 
UUU. Ul 1 


26 


tneagher 1 


2 


. $ 


12, 


£ A A A *! 1 

000.01 1 


67 


monroe 1 


22 


$ 


1 o 
1 0, 


900. 01 1 


42 


newhall i 


1 

1 o 




10 , 


000. 01 1 


■3 A 


pa V V 1 


1 7 


It 
•P 


1 11 
14 , 


AAA A 1 1 

UOO .01 1 




j 




1 $ 


126 


801 10 ! 


U Jl 3 


DarKer 1 


1 u 


* 


32, 


800.01 ! 


7Q 
/ 0 




Q 
J 


«P 


10, 


900.01 1 


UK 
HD 


ka t z I 


5 


■ $ 

I* 


12, 


400.01 1 


70 


m<MORE> 1 


1 


. $ 


14, 


800.01 ! 


57 


marcus 1 


21 


$ 


12, 


600.01 1 


62 


mccory 1 


16 


$ 


12, 


700.01 1 


54 


mealey 1 


11 


$ 


21, 


600.01 i 


36 


nevitte 1 


7 


1 $ 


14, 


900.01 1 


39 



SEX 



female 



female 
male 



male 



female 



female 
male 



195 
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To see how the totals feature works, the last page of the report must be examined. 
The example eliminates page breaks to cut down on the number of pages generated. 

197 ! linus: sfo -tt age salary job 
199 ! linus: sfo -pb 



Just as retrieved data can be re-used, so can formatted reports. The last few 
pages will be examined, but display will be asked to keep the formatted report. 
It will use the previously established temp_dir to place the copy of the formatted 
report . 
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201 ! linus: di -kr -or -krp -pg 33,$ 



04/29/83 
STATE 



Sample Report 



10: 52 



vt 
vt 

vt 

vt 
wa 



CITY 



rutland 
rutland 

rutland 
Seattle 



Seattle 

Seattle 
walla walla 



i NAME 1 
1 1 


JOB 




SALARY 




AGE 


1 SEX 


1 F 
i A 
! M 
1 I 


1 parnell 1 


1 


1 $ 


14, 400. 


01 1 


59 


1 male 


! L 
1 Y 

1 m 


1 1 




1 <P 


• 33, *:UU. 


no I 
09 1 


U A A 
400 


1 male 






O 1 Q 
d. \ 0 


1 $ 


24o ,511. 


1 O 1 


A AO 

992 






[ ] 
' ' 


431 


$ 


478, 51 1 . 


3d 1 


1 ODD 






! aziz 1 


6 


$ 


14, 100. 


01 1 


75 


1 female 




1 freitag I 


2 


$ 


13, 000. 


01 1 


66 




! d 


1 Johnson 1 


22 


$ 


18, 900. 


01 1 


25 




! s 


1 maclean I 


1 Q 
1 0 




1 A AAA 

10 , 000. 


A 1 1 

01 j 


1 II 
74 




1 m 


1 ulsnUnC.^ 1 


1 "3 

1 3 




1 4 , UUU . 


U 1 1 


0 I 




1 A 

1 u 




o 

o 




1 O £AA 

1 i:, oOO. 


A i 1 

0 1 1 


'7 O 

72 




1 s 




11 


<i^ 


1 A OA A 

1 U , ifOO . 


A 1 1 

0 1 1 


d7 




1 m 


1 nei I 1 






n inn 
y, 100. 


A 1 1 

0 1 1 


Ob 




1 d 


1 0 ' neil 1 




it 


i O i A A 
\C.^ 100 . 


A 1 1 

0 1 1 


)l A 

49 




1 s 


[ } 
' ' 


1 1 "7 
1 1 f 


$ 


1 1 )l AAA 
1 1 »t , 000 . 


AA 1 
09 1 


C A A 

boo 


! 

1 female 




1 collier 1 


16 


$ 


13, 000. 


01 i 


62 


1 male 




1 janick i 


1 1 


$ 


20, 200. 


01 I 


50 




1 m 


1 latter i 


7 


$ 


15, 300. 


01 1 


55 




1 d 


! m<MORE> ! 


3 


$ 


12, 400. 


01 1 


66 




1 s 


1 m<MORE> 1 


23 


$ 


12,500. 


01 1 


43 




1 m 


1 mcrorie 1 


19 


$ 


4, 000. 


01 1 


40 




1 d 


1 mock 1 


1 H 




OA i A A 

30 , 100 . 


A "l 1 

0 1 1 


o o 




1 s 


1 neil 1 1 


9 




1 A D AA 

1 0 , oUO . 


A 1 1 

0 1 1 


II n 

47 




1 m 


1 patei 1 


ir 




i O AAA 

1 d , 000 . 


A i 1 

0 1 1 


O )l 

24 




1 d 


[ [ 


107 




i O A OA A 

1 30, 300. 


A A 1 

09 1 


409 


male 




[ { 
' ' 


O O II 




O ll )l OA A 

244 , 300. 


1 O 1 

1 0 1 


969 






1 colwell i 


18 


$ 


10, 200. 


01 I 


38 


! female 


m 


! i An i n <i ! 


1 






0 1 ! 


4 1 
** 1 




1 0 


1 lawson 1 


8 


$ 


13, 000. 


01 1 


34 




1 s 


1 m<MORE> i 


4 


$ 


10, 500. 


01 1 


70 




1 m 


1 mcclaus 1 


24 


$ 


9, 000. 


01 1 


51 




1 d 


I mcswain 1 


20 


$ 


12, 400. 


01 1 


35 




1 s 


1 modlin I 


15 


$ 


13, 100. 


01 1 


50 




1 m 


1 nelson I 


10 


$ 


11,700. 


01 1 


37 




1 d 


1 Patrick 1 


6 


$ 


14, 300. 


01 1 


29 




1 s 




118 


$ 


109,201. 


09 1 


385 


female 
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04/29/33 

STATE I CITY 



Sample Report 



10: 52 



wa 



wa 

wa 

wa 
wi 



walla walla 



walla walla 



walla walla 



green bay 



green bay 

green bay 
racine 



1 NAME i 
1 1 


JOB 




SALARY 




AGE 


i SEX 


i F 
1 A 
1 M 
j I 


1 1 
j 1 
' ' 

i bahn I 


7 


$ 


14, 900. 


01 1 


55 


male 


j L 
1 Y 

i d 


1 freuh 1 


3 


$ 


12, 900. 


01 i 


76 




1 S 


1 jones I 


23 


$ 


12, 800. 


01 1 


36 




1 m 


1 macleod ! 


19 


$ 


4, 200. 


01 1 


60 




! d 


1 manion j 


14 


$ 


32, 400. 


01 1 


68 




1 s 


j m<MORE> i 


9 


$ 


10, 700. 


01 1 


68 




! m 


1 mittal 1 


5 


$ 


12, 000. 


01 1 


43 




1 d 


1 negri I 


1 


$ 


15, 200. 


01 1 


68 




! s 


1 oong 1 


21 


$ 


12, 000. 


01 1 


70 




! m 


! ' 


102 


$ 


127, 100. 


09 1 


544 


1 male 


! 
1 


! ! 


220 


$ 


236, 301 . 


18 1 


92 9 




1 

, 


1 \ 
' ' 


444 




480 601 


^6 1 


1 898 




[ 


! ha 1 1 A V ! 






12 410. 


01 1 


25 


1 X dll CI X 7 


! e 
1 O 


1 fyock I 


4 


$ 


1o[ 801. 


01 1 


47 




! m 


1 June 1 


24 


$ 


9, 210. 


01 1 


47 




1 d 


1 m<MORE> 1 


20 


$ 


12, 800. 


01 1 


35 




! s 


1 mann 1 


15 


$ 


13,000. 


01 1 


52 




1 m 


! m<MORF> ! 


1 0 




12, 000. 


01 j 


5 1 




I d 


1 moc k 1 


6 




14 , 800. 


01 i 


78 




j 3 


! n A "i 1 1 i 

1 ii C J. J. X 1 


2 


1 "P 


12, 200. 


01 1 


^0 




I m 


! r\Y\n f*! 1" A ! 


22 




1 8 800 


01 1 


77 




1 d 


1 ! 


111 




1 1 6 021 


OQ 1 


442 


1 X 7 HI d X c 




! cr>Y\c\ i 1" 1 


1 Q 




4 ^00 


01 1 


56 


1 male 


1 


1 jochera I 


14 


$ 


30, 800. 


01 1 


79 




i S 


1 lawter I 


9 


$ 


10, 400. 


01 1 


74 




1 m 


1 macleod 1 


5 


$ 


12, 400. 


01 1 


36 




1 d 


j m<MORE> 1 


1 


$ 


14, 400. 


01 I 


52 




i S 


1 m<MORE> 1 


21 


$ 


12, 400. 


01 ! 


60 




1 m 


! mohin I 


16 


1 $ 


12, 000. 


01 1 


34 




! d 


1 nesllne 1 


1 1 


I $ 


20, 500. 


01 1 


37 




! s 


1 D<MORE> 1 


7 




1 5 000 


01 i 


45 




1 m 


I 1 
' ' 


10"? 




1-32 200 


OQ ! 


47"^ 


I male 


1 
' 




214 


$ 


248, 221 . 


18 1 


915 






1 c<MORE> 1 


20 


. $ 


12, 500. 


01 ! 


20 


1 female 


1 s 


i Johnson I 


15 


! $ 


12, 410. 


01 1 


61 




I m 


i led ford i 


10 


$ 


1 1 , 200. 


01 1 


63 




1 d 


1 maclln 1 


6 


1 $ 


14, 200. 


01 ! 


25 




! s 
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04/29/83 



Sample Report 



10: 53 



STATE 


1 CITY 


1 NAME 

1 1 

1 ] 
1 ] 


JOB 




SALARY 




AGE 


SEX 


W 1 


ra c in e 


j i 

• MHR C S ' 

1 nisPlUnC.x 1 


2 


* 


1 p finn 

1 <1 , uu u . 


0 1 


j-3 


1 cUi d X c 






1 m<MORE> 1 


22 


$ 


1 8, 700. 


01 


38 








1 moldt 


18 


' $ 


10, 200. 


01 


67 








! n<MORE> 1 


13 


$ 


14, 400. 


01 


71 








! patton ! 

1 ] 


8 


$ 


12, 100. 


01 


27 








1 ] 


1 14 


$ 


118, 310. 


09 


407 


female 






1 baker 


9 


$ 


12, 000. 


10 


43 


male 






1 gardner 1 


5 


$ 


12, 300. 


01 


29 








1 J up X O c f 1 


1 






0 1 


4 1 








1 m<MORE> I 


21 


' $ 


12, 600. 


01 


32 








1 tnansour I 


16 


$ 


13, 100. 


01 


46 








1 111 L u i. Uii ^ 1 


1 1 
1 1 


<fe 


? 1 ion 


n 1 










1 modlin 


7 


' $ 


14, 300. 


01 


60 








1 nelson 


3 


$ 


12, 400. 


01 


70 








1 u N. n n El ✓ 1 




* 


1 p ftnn 


n 1 


u c 




Wl 


IT fly 1 K\ A 

I a vj X li c 


j J 


Qfi 
y o 


4: 


1 ?ii on 1 


1 ft 
1 o 


"t <1 ^ 


rn a 1 e 


wi 


racine 




210 


$ 


243,21 1. 


27 


82 9 




wi 






424 


$ 


491 , 432. 


45 


1744 










12300 


$13,81 1,845. 


15 


49106 
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Now that the report appears correct, it can be written (saved) to a file. -old_report 
will be specified so that display uses the previously formatted report. 

203 ! linus: di -orp -of SAMPLE_REPORT -kr | 

The complete report (SAMPL£_REPORT ) now resides in the user's working directory and 
can be dprinted at will. The -keep_retrieval control argument was specified in order 
to continue this session, but could have been eliminated if the user was terminating 
the session after saving this report. 
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Now we will experiment with generation of a report utilizing the group footer/header 
and left/right trim operations. 



18 
19 
20 
21 
22 
23 
24 
25 
26 

28 
29 
30 

31 



1 
3 
5 
7 

9 
10 

11 
12 
13 
14 
15 
16 ! 



linus: sfo -rs 

linus: sfo -pw 60 -tl off -pb state 

linus: sfo -ex 1 2 3 4 5 6 7 8 -gr state city 

linus: sfo -gft city -ght city 

linus: sfo -gfv -prompt -ghv -prompt 
Enter -group footer value. 
! ! ! ! 

Enter -group header_value . 
•City: [civ city] ! ! ! 

III! 



! linus: sfo -phv -prompt -pfv -prompt 

Enter -page_header value. 
! ! State: [civ stateT! ! ! 
I I ! ! I 

! i 

Enter -page_footer_value. 
I I ! 1 1 

! !!- Page [dib page_number] -!! 



linus: sfo -rhv -prompt 
Enter -row_header_value . 

Employee [rtrim [civ name]] is [Itrim [civ age]] years old and earns 
[pic $z9, 999V.99 [civ salary]]!!! 



33 ! linus: di -or -kr -sort state city salary -pg 1,3 
37 State: ak 

39 City: juneau 

40 Employee molloy is 22 years old and earns $ 4,300.01 
Employee ord is 34 years old and earns $ 9,200.01 
Employee manuel is 33 years old and earns $10,000.01 
Employee nesline is 27 years old and earns $10,100,01 
Employee paul is 73 years old and earns $10,300.01 
Employee bambry is 66 years old and earns $11,501.01 
Employee justin is 78 years old and earns $12,000.01 
Employee cooke is 34 years old and earns $12,100.01 
Employee mcclenehan is 71 years old and earns $12,100.01 
Employee mead is 29 years old and earns $12,700.01 
Employee jones is 21 years old and earns $13,000.01 
Employee meadoows is 77 years old and earns $13,000.01 
Employee abel is 36 years old and earns $14,555.01 
Employee gaskins is 31 years old and earns $14,700.01 
Employee maclure is 53 years old and earns $14,700.01 
Employee mccormick is 67 years old and earns $14,900.01 
Employee macleod is 43 years old and earns $18,500.01 
Employee ledger is 27 years old and earns $21,900.01 
Employee nevling is 63 years old and earns $32,500.01 

. (37 blank lines) 



97 
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line 1-5 

Resets all options (i.e., restore the report back to its original format), 
set page width to 60, turn title line "off," set the page break to 
"state," exclude all 8 columns of the report, and group the report by 
"state" and "city." 

line 7 

Sets the group footer/header trigger to "city." 
line 9-16 

Sets the group footer value to a blank line (!!!!) and the group header 
value to "City:" (left- justified) . 

line 18-26 

Sets the page header value to "State:" (left- justified) , the page footer 
(2 lines) to contain a blank line (!!!!), and the second footer line to 
"- Page X -". 

line 28-31 

Sets the row header value to read (left- justified and trimmed): 
Employee X is X years old and earns $X 

line 33 

Invokes display, using the sort sequence "state city salary." 
line 37 - 225 

System display — notice that the top of each page (lines 37, 101, 165) 
indicate a report by state (ak, az, ca). Additionally, the report is 
sorted by city, where: 

ak - juneau (line 39) 
az - phoenix (line 103) 

- tucson (line 121 ) 
ca - fresno (line 167) 

- los angeles (line 185) 

- Sacramento (line 207) 

and finally employees are listed in ascending salary order. 
The remaining two pages of the report follow. 
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101 



state: az 



103 City: phoenix 

Employee manzo is 74 years old and earns $ 4,200.01 
Employee meadow is 52 years old and earns $ 9,800.01 
Employee raeagher is 52 years old and earns $10,500.01 
Employee mcclowsky is 68 years old and earns $10,800.01 
Employee June is 73 years old and earns $10,900.01 
Employee dupuis is 28 years old and earns $12,000.00 
Employee kane is 58 years old and earns $12,300.01 
Employee maclin is 79 years old and earns $12,500.01 
Employee macmahon is 37 years old and earns $12,600.01 
Employee abell is 55 years old and earns $13,000.01 
Employee geist is 21 years old and earns $14,600.01 
Employee lednar is 71 years old and earns $15,000.01 
Employee corcoran is 38 years old and earns $18,300.01 
Employee bander is 70 years old and earns $21,100.01 
Employee mccoy is 67 years old and earns $31,300.01 



121 City: tucson 

Employee pauley is 56 years old and earns $11,600.01 
Employee monaco is 30 years old and earns $12,300.01 
Employee nevitte is 77 years old and earns $12,300.01 
Employee neubauer is 57 years old and earns $12,400.01 
Employee ordeman is 21 years old and earns $15,200.01 

. (33 blank lines) 
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165 State: ca 



167 City: fresno 

Employee jupiter is years old and earns $ 4,100,01 
Employee maclure is 47 years old and earns $ 9,700.01 
Employee kang is 76 years old and earns $10,000.01 
Employee macmannis is 32 years old and earns $10,200.01 
Employee meakin is 51 years old and earns $11,600.01 
Employee george is 44 years old and earns $12,100.01 
Employee costello is 53 years old and earns $12,400.01 
Employee abernathy is 61 years old and earns $12,500.01 
Employee mccrary is 53 years old and earns $12,500.01 
Employee marcey is 71 years old and earns $12,600.01 
Employee monger is 61 years old and earns $12,600.01 
Employee mcclung is 71 years old and earns $13,100.01 
Employee meadoows is 26 years old and earns $14,100.01 
Employee bane is 50 years old and earns $15,200.01 
Employee leeland is 77 years old and earns $32,800.01 

185 City: los angeles 

Employee cowes is 58 years old and earns $ 9,500.01 
Employee newhall is 30 years old and earns $10,000.01 
Employee aboe is 41 years old and earns $10,201.01 
Employee giannoti is 45 years old and earns $10,900.01 
Employee macmillan is 52 years old and earns $11,400.01 
Employee leestma is 69 years old and earns $12,300.01 
Employee katz is 70 years old and earns $12,400.01 
Employee orf is 70 years old and earns $12,400.01 
Employee marcus is 62 years old and earns $12,600.01 
Employee meagher is 67 years old and earns $12,600.01 
Employee mccory is 54 years old and earns $12,700.01 
Employee Justin is 34 years old and earns $12,900.01 
Employee pavlov is 24 years old and earns $14,000.01 
Employee macmahon is 57 years old and earns $14,800.01 
Employee nevitte is 39 years old and earns $14,900.01 
Employee mccormick is 26 years old and earns $15,000.01 
Employee monroe is 42 years old and earns $18,900.01 
Employee mealey is 36 years old and earns $21,600.01 
Employee barker is 78 years old and earns $32,800.01 

207 City: sacramento 

Employee newman is 68 years old and earns $ 4,200.01 

Employee orlaens is 41 years old and earns $10,300.01 

Employee mccullough is 62 years old and earns $10,900.01 

Employee gill is 47 years old and earns $11,800.01 

Employee macmannis is 54 years old and earns $12,200.01 

Employee newcomb is 36 years old and earns $12,300.01 

Employee kane is 24 years old and earns $12,400.01 

Employee barrett is 65 years old and earns $12,800.01 

Employee abodoura is 61 years old and earns $12,900.01 

Employee leonard is 25 years old and earns $12,900.01 

Employee meakin is 71 years old and earns $12,900.01 

Employee monson is 40 years old and earns $13,000.01 

Employee mccoy is 77 years old and earns $14,000.01 

Employee keene is 54 years old and earns $14,100.01 

225 - Page 3 - 



4-65 



AZ49-03 



229 ! linus: q 

230 (Multics command level - ready message) 
This concludes the sample user session. 
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SECTION 5 



COMMAND DESCRIPTION 



This section contains a description of the linus command and its associated 
requests. Each request description contains the name (including the abbreviated 
form, if any) , discusses its purpose, and shows correct usage. Notes and examples are 
included where necessary for clarity. 
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1 inus 



linus 



Name: linus 



This command invokes linus to access an MRDS data base. It provides both 
retrieval and update operations. Data to be selected is specified via query 
I statements . 



I 



Note: The linus command (pre-MR10.2 version) is described in Section 6. 



Usage 



linus {-control args} 



where control__args can be chosen from the following: 
-abbrev, -ab 

enables abbreviation expansion and editing of request lines. 



-iteration, -it 

recognizes parentheses in the request line to indicate request line 
iteration . 

-no__abbrev, -nab 

disables abbreviation expansion and editing of request lines . (Default) 

-no_iteration , -nit 

interprets parentheses in the request line literally ( i.e . , no iteration 
of request line). (Default) 

-no__prompt, -npmt 

turns off prompting of strings. This control argument can be overridden 
later (see set_mode request). (Default is prompt) 

-no__start__up , -nsu 

specifies that the subsystem start__up exec^com is not to be executed. 

-profile path, -pf path 

specifies the pathname of the profile used for abbreviation expansion . A 
profile suffix must be the last component to path; however, the suffix 
need not be supplied in the command line. This control argument implies 
-abbrev . 

-prompt STR 

sets the prompting string used by linus to STR. If STR contains embedded 
blanks, it must be enclosed in quotes. (Default linus prompt is 
"linus:".) 

-request STR, -rq STR 

executes STR as a linus request line before entering the request loop. 
This control argument cannot be used with the macro_path argument 
described in Section 6, and the requests specified by STR cannot contain 
the invoke request, also described in Section 6. 

-start__up , -su 

specifies that the subsystem start__up exec^com "start_up .lec" is 
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1 inus 



linus 



executed prior to entering the request loop. The start_up is searched 
for in the user's home directory, project directory, and then >site. 
(Default) 



Notes 



By default, linus prompts the user whenever input is expected (the string 
"linus:" is displayed at linus request level). Refer to the description of the 
set_mode request for information on how to turn off prompting. 



Multics program_interr upt conditions are recognized and handled by linus. 
Thus, the user may interrupt any request and resume the linus session by invoking the 
Multics program_interr upt command . After the program_interrupt command , linus waits 
for the user to type further requests. 



There is no data base creation facility within linus. Those users who wish to 
create their own data base should refer to Section 3 for information on the creation of 
an MRDS data base. 
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1 inus 



linus 



LIHUS Requests 



The following list summarizes all of the linus requests. 



Identifies the linus subsystem, version number, and open data base. 

9 

lists the available linus requests, 
abbrev, ab 

turns abbreviation processing ON or OFF and changes profile segments. 

answer 

supplies an answer to a question, 
apply, ap 

places the current query in a temporary file, adds the file name to the 
supplied command line, and executes the Multics command line. 

assign_values , av 

specifies that selected data is to be retrieved and that retrieved values 
are to be assigned to the designated variables. 

close, c 

closes the currently open data base. 

column_value , civ 

returns the value of the specified column for the current row, previous 
row, or next row, 

create_list, els 

specifies that selected data is to be retrieved and written to a Lister 
file to create a formatted report. 

declare, del 

allows the user to declare user-written functions for later invocation 
within the selection expression. 

def ine__temp_table , dtt 

specifies that selected data is to form a new temporary table, known only 
to the process, but which can be accessed by the process for retrieval in 
the same manner as data base tables. 

del__scope, ds 

deletes all or a portion of the current scope of access in a shared data 
base . 

delete, dl 

specifies that selected data is to be deleted from the data base. 

delete__temp__table , dltt 

deletes the specified temporary table. 

display, di 

retrieves selected data, creates a report, and displays the information 
or writes it to a file. 

display__buil tins , dib 

returns the current values for requested built-ins. 
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linus 



linus 



do 

substitutes args into the request_line and passes the result to the linus 
request processor. 

exec_com, ec 

executes the linus exec_com indicated by ec_path. The ec_path arguments 
are passed to the exec__com processor. 

execute, e 

executes a Multics command line after evaluating linus active requests. 
forraat_line, fl 

returns a single, quoted character string, formatted from an ioa__ control 
string. 

help 

displays information about request names or topics. A 1 ist of available 
topics is produced by the list__help request. 

if 

conditionally executes a request. 
input_query, iq 

allows the entering of a query for data manipulation requests, 
invoke, i (an OBSOLETE request moved to Section 6) 
lila (an OBSOLETE request moved to Section 6) 
list_db, Idb 

lists specified information about the currently open data base. 



list__format__options , Isfo 

lists the names and values of format options. 

list_help, Ih 

lists the available info segments whose names include a topic string. 

list__requests , Ir 

lists information about linus requests. 

list__scope, Is 

lists the scope of access currently in force. 

list__values ,lv 

lists the current value assigned to the designated linus variables. 

Itrim 

returns a character string trimmed of specified characters on the left, 
modify, m 

specifies that a selected portion of the data base is to be modified. 

open , o 

opens a specified data base, with either a data model or data submodel 
view, for linus processing. 

opened_database , odb 

returns "true" if there is an open data base and "false" if there is no 
open data base. 
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linus 



picture, pic 

returns one or more values processed through a specified PL/I picture, 
print, pr 

specifies that selected data is to be retrieved and displayed on the 
terminal in default format. 

print__quer y, pq 

displays the current query. 

qedx, qx 

invokes the qedx editor with the current or a new query. 

quit, q 

terminates a linus session, 
report, rpt 

specifies that selected data is to be retrieved and used to create a 
formatted report via the Multics Report Program Generator (MRPG). 

restore_format__options , rsfo 

restores saved report layouts. 

rtrim 

returns a character string trimmed of specified characters on the right. 

save_format_options , svfo 

saves current values of format options for future use. 

save_qiiery, sq 

saves the current query. 

set_format_options , sfo 

changes/sets report format options. 

set__mode, sm 

sets or resets modes for the current session. 

set_scope , ss 

defines the current scope of access within a shared data base (this, 
together with del__scope, provides concurrent usage control). 

store, s 

adds new rows to specified tables in the data base. 

store_from_data_f ile , sdf 

takes new rows from a file and adds them to the specified table in the data 
base. 

string 

returns a single character string formed by concatenating all of the 
strings together, separated by single spaces. 

subsystem_name 

displays the name of the subsystem, "linus". 

subsystem_ver sion 

displays the current version of linus. 

translate__ query, tq 

translates the current query, making it available for data manipulation 
requests . 
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linus 



write, w 

specifies that selected data is to be retrieved and written to a file in 
the storage system, in the storage system. 

write_data__^f ile , wdf 

" retrieves selected data and writes it to a file in a format suitable for 
input to the store_from__data_f ile request. 



The remainder of this section contains a detailed description of each request, 
including standard subsystem environmental requests (i.e., requests common to other 
subsystems such as abbrev, answer, do, etc). All examples show the prompting string 
"linus:" prior to lines of user input. 
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9 



Request: . 

This request identifies the linus subsystem, version number, and open data base. 



Example 



The following list is displayed when "?" is entered by the user in response to 
the linus prompt. 



linus: ? 

linus: Available linus requests: 



Usage 



Request: ? 



This request displays the available linus requests. 



Usage 



9 



abbrev, ab 

answer 
apply, ap 
assign_values , av 
close, c 

column_value , civ 
create_list, els 
declare, del 
def ine__temp_table , dtt 
delete_scope , ds 
delete, dl 
delete__temp_table , 



help, h 
if 

input_query, iq 
invoke, i 



report, rpt 

restore__format_options , 



rsfo 
rtrim 

save_format_options , 



Isfo 

list_requests , Ir 
list__scope. Is 
list_values, Iv 
Itrim 
modify, m 
open , o 

opened_database 
picture, pic 
print, pr 
print_query, pq 
qedx, qx 
quit, q 



lila 

list_db, Idb 
list_help, Ih 
list_format__options , 



svfo 
save_query, sq 
set_forrpjat_options , 



sfo 

set_mode, sm 
set__scope, ss 
store, s 

store_from__data__f ile , 



I 



dltt 
display, di 
display__buil tins , dib 
do 

exec_cora, ec 
execute, e 
format__line, fl 



sdf 
string 

subsystem_name 

subsystem_version 
translate_quer y, tq 
write, w 

write__date__f ile , wdf 



Type "list__requests" for a short description of the requests. 
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abbrev 



Request: abbrev, ab 



This request controls abbreviation processing within the subsystem. As an 
active request, it returns "true" if abbreviation expansion of request lines is 
currently enabled within the subsystem and "false" otherwise. 



Usage 

ab { -control_args} 



Usage as an Active Request 



[ab] 

where control_args can be chosen from the following (and cannot be used with the active 
request) : 

-off 

specifies that abbreviations are not to be expanded. 

-on 

specifies that abbreviations should be expanded. (Default) 
-profile path 

specifies that the segment named by path is to be used as the profile 
segment ; the profile suffix is added to path if not present . The segment 
named by path must exist. 



Notes 



This subsystem provides command line control arguments (-abbrev, -no_abbrev, 
-profile) to specify the initial state of abbreviation processing within the 
subsystem. For example, a Multics abbreviation can be defined to invoke the read_mail 
subsystem with a default profile as follows: 



.ab rdm do "read_niail -abbrev -profile [hd]>mail_system &rf1" 



If invoked with no arguments, this request enables abbreviation processing 
within the subsystem using the profile that was last used in this subsystem 
invocation. If abbreviation processing was not previously enabled, the profile in 
use at Multics command level is used; this profile is normally 
[hoffle_dir]>Person_id .profile. 



See the abbrev command in the Multics Commands for a description of abbreviation 
processing. 
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answer 



Request: answer 



This request provides preset answers to questions asked by another request. 



Usage 

answer STR {-control_args} request_line 

where: 

1. STR 

is the desired answer to any question. If the answer is more than one 
word, it must be enclosed in quotes. If STR is -query, the question is 
passed on to the user. The -query control argument is the only one that 
can be used in place of STR. 

2. request_line 

is any subsystem request line. It can contain any number of separate 
arguments (i.e., have spaces within it) and need not be enclosed in 
quotes. 

3. control_args 

can be chosen from the following: 

-brief, -bf 

suppresses display (on user terminal) of both the question and the 
answer , 

-call STR 

evaluates the active string STR to obtain the next answer in a sequence. 
The active string is constructed from subsystem active requests and 
Multics active strings (using the subsystem "execute" active request). 
The outermost level of brackets must be omitted (i.e., "forum_list 
-changed") and the entire string must be enclosed in quotes if it contains 
request processor special characters. The return value "true" is 
translated to "yes," and "false" to "no." All other return values are 
passed as is. 

-exclude STR, -ex STR 

passes on , to the user or other handler , questions whose text matches STR. 
If STR is surrounded by slashes (/), it is interpreted as a qedx regular 
expression. Otherwise, answer tests whether STR is literally contained 
in the text of the question. Multiple occurrences of -match and -exclude 
are allowed (see "Notes" below) . They apply to the entire request line. 

-match STR 

answers only questions whose text matches STR. If STR is surrounded by 
slashes (/) , it is interpreted as a qedx regular expression. Otherwise, 
answer tests whether STR is literally contained in the text of the 
question. Multiple occurrences of -match and -exclude are allowed (see 
"Notes" below). They apply to the entire request line. 

-query 

skips the next answer in a sequence , passing the question on to the user . 
The answer is read from the user i/o I/O switch. 
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answer 



apply 



-then STR 

supplies the next answer in a sequence, 
-times N 

gives the previous answer (STR, -then STR, or -query) N times only (where 
N is an integer) . 



Notes 



The answer request provides preset responses to questions by establishing an ON 
unit for the condition command_quest ion and then executes the designated request 
line. If any request in the request line calls the command_query_ subroutine 
(described in the Multics Subroutines) to ask a question, the ON unit is invoked to 
supply the answer. The ON unit is reverted when the answer request returns to 
subsystem request level . See "List of System Conditions and Default Handlers" in the 
REF Manual for a discussion of the command_question condition. 



If a question is asked that requires a yes or no answer, and the preset answer is 
neither "yes" or "no," the ON unit is not invoked. 



The last answer specified is issued as many times as necessary, unless followed 
by the -times N control argument. 



The -match and -exclude control arguments are applied in the order specified. 
Each -match causes a given question to be answered if it matches STR; each -exclude 
causes it to be passed on if it matches STR. A question excluded by the -exclude 
control argument is reconsidered if it matches a -match later in the request line. For 
example, the request line: 

answer yes -match /fortran/ -exclude /fortran_io/ -match /'*fortran_io/ 

answers questions containing the string "fortran", except that it does not answer 
questions containing "fortran_io" . It does, however, answer questions beginning 
with "fortran io". 



Request: apply, ap 



This request places the current query into a temporary file, adds the pathname of 
the file to the end of the supplied command line, and executes the resulting Multics 
command line. If there is no current query, or the -new control argument is used , the 
created file is initially empty. 



Usage 



ap {-control__argsl command_line 



where : 

1. control_args 

can be chosen from the following: 
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apply 



assign_values 



-new 

specifies that an empty file be initially created. 

-old 

specifies that the existing query be made available. (Default) 

2, command__line 

is a Multics command line request. 



Example 



apply -new ted -pn 
apply emacs 



Request: assign^values , av 



This request specifies that selected data is to be retrieved and the retrieved 
values assigned to designated linus variables. This capability allows information 
obtained from one retrieval to be used in subsequent data base accesses . A translated 

I or translatable query must be available. As an active request, it returns "true" if 
data is successfully retrieved and "false" if the select statement fails. 



Usage 



I av variable__list 



I Osage as an Active Request 

I [av variable__list] 

where variable list is a list of one or more variable names. 



Notes 



A variable name is an alphanumeric character string, from 1 to 32 characters in 
length, which must begin with an exclamation mark (!). The under score (__) and hyphen 
(- ) may also be included , but the exclamation mark cannot appear elsewhere in the name. 
The specification in an assign__values request is the only declaration required. If 
the same variable is specified in several assign__values requests, its value is 
reassigned in each of those requests. Variable names and values are preserved across 
data base openings and closings within the same linus session. 

Variables specified in the assign__values request are unrelated to row 
designators in the query. 
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assign values 



Retrieved data is assigned to variables in the variable_l ist in the order 
retrieved. Retrieval ceases when all selected data is exhausted or when all variables 
in the var iable_l ist are exhausted, whichever occurs first. In the case of the 
retrieved data being exhausted before the variable_list , the following occurs: 
previously assigned variables that occur in a variable list but are not assigned new 
values by this assign_value request retain their previous value . New variables in the 
variable list that are not assigned values are not created. 



Variable names are global within a linus session ( i .e . , like variable names 
occurring in different linus exec_coms refer to the same variable) if the exec_coras 
are used in the same linus session. 



Example 



List the employees whose total compensation is above the department store 
average, and then list those employees who are below the average. 

linus: input_query -force 
Query: 

avg {select sal + coram from emp} 



linus: assign_values ! av_comp 
linus: input_query -force 
Query: 

select name sal + comm 
from emp 

where sal + comm > !avg_comp 



linus: print 

name f(erap) 

Smith, John 10000 
Jones, Al 12000 
Johnson, Betty 11000 
(END) 

linus: qedx 

3s/>/</ 
1,$ p 

select name sal + comm 
from emp 

where sal + comm < !avg_comp 

write 

quit 

linus: print 

name f(emp) 

Anderson, Carol 8000 
(END) 
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close column value 



Request: close, c 

This request closes the currently open data base. 



Usage 



Request: column^value, civ 



This request returns the value of the specified column for the current row, 
previous row, or next row. It can only be used as an active request . It is used within 
a formatted report produced by the display request to obtain the value of a column . It 
is an error to use this request anywhere except in a header/footer or editing string 
within a report produced by the display request. 

I Usage as an Active Request 



[civ column id {-control args}] 



where : 



1. coluran_id 

specifies which column value is to be returned. It can be given as the 
name of the column as defined in the open model/submodel , or the number of 
the column in the query. 



2. control__args 

can be chosen from the following: 



-current_row, -crw 

returns the value of the named column for the current row. (Default) 



-default STR 

returns the character string STR when there is no previous row, or when 
there is no next row. (If this control argument is not used the default 
value for STR is "".) 

-next__row, -nrw 

returns the value of the named column for the next row. If there is no 
next row, the string is returned unless changed by the -default control 
argument . 

-previous_row, -prw 

returns the value of the named column for the previous row. If there is no 
previous row, the string is returned unless changed by the 
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column value create list 



Examples 



[column_value foo] 

[colutnn_value 31 

Ccolumn_vaXue foo -previous_row] 

[column value foo -next row -default NULL] 



Request: create__list , els 

This request specifies that selected data is to be retrieved and written to a 
specified Lister file. This file can be manipulated via Lister commands to create a 
formatted report . A translated or translatable query must be available . Refer to the 
WORDPRO Manual for a complete description of Lister. 



Usage 



els path {-control__args} 



where : 



1. path 

is the pathname of a Multics file into which the selected data is to be 
written . The data is written in a form suitable for processing by Lister . 
The suffix lister is appended to the pathname (if not present in the 
invocation) and the file is created if it does not exist. If the file 
currently exists, it is truncated unless the -extend control argument is 
specified . 

2. control_args 

can be chosen from the following; 

-extend 

specifies that if the Lister file already exists, it is to be added to 
rather than truncated. The field names (either default or explicitly 
specified) must be identical to those defined in the existing file. 

-field_names STR, -fn STR 

explicitly specifies the field names in the Lister file being created or 
extended. STR is a list of field names that must correspond in order and 
quantity to the items specified in the select clause of the associated 
query. This control argument must be specified if the query select 
clause contains an expression. If not specified, the names of the 
selected data base columns become the lister file field names. 



NOTE: The values being written to the lister file have all leading and trailing 
blanks stripped off. 
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create list 



declare 



Examples 



A query to create a Lister file containing the names and salaries for all 
employees in the Shoe department is: 

linus: input_query -force 
Query: 

select name sal 
from etnp 

where dept = "Shoe" 



A.request to create the Lister file "shoe__sal .1 ister" with the field names "name" 
and "sal" is: 

linus: create__list shoe__sal 

The same file could be created with the field names "name" and "salary" with the 
request : 

linus: create__list shoe__sal -f ield__names name salary 



Request: declare, del 



This request allows the user to declare a nonstandard function which may be 
invoked in a subsequent query. A nonstandard function is any function not included in 
built-in functions listed in Section 2, and may be user-written or may be provided by 
the local installation. Two types of functions may be declared: set functions which 
operate on multiple sets of values ( for example , sum {...}) and scalar functions which 
operate on one occurrence of a set of values. 



Usage 



del fn^name fn_type 
where : 

1 , fn_name 

is the name of the function being declared . The fn_name must be the name 
of an object segment that can be found using the search rules currently in 
effect. 

2. fn__type 

is the type of the function being declared . Two types are permitted , set 
or scalar. A set-type-function operates on multiple sets of selected 
values, whereas a scalar-type-function operates on one set of specified 
values. An example of a set function is: 

avg {select salary 
from emp} 

while a scalar function example would be: 
substr (name 1, 5) 
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declare 



d e f in e__t emp_ta bl e 



Notes 



Scalar functions can accept column values as input from one table only, provided 
no row designators are used . If row designators are specified , column names must all 
be qualified with the same row designator. 

Several built-in functions are provided as a standard part of 1 in us . See Section 
2 for a description of these functions. It is not necessary to declare built-in 
functions. If a declared function has the same name as a built-in function, the 
declared function, rather than the built-in function, is invoked when the function 
name is referenced. 



Example 



To find the average sales volume of all items made of cotton in a specific 
department, several assumptions are made: 1) that the item code contains encoded 
information indicating the material of which an item is made, 2) that the user-defined 
scalar function "material" returns this information, and 3) that there is a 
user-defined set function "dept_avg" that calculates the desired average, which is 
the total volume divided by the number of departments. 

linus: declare material scalar 
linus: declare dept_avg set 

These functions may now be used in a query as: 

linus: input_query -force 
Query: 

dept_avg {select dept vol 
from sales 

where material (item) = "cotton"} 



Request: def ine_temp_table, dtt 



This request causes selected data to be placed into a temporary table that can 
then be referenced as any other table in the data base for retrieval purposes. This 
feature is useful from an efficiency standpoint , since mul tiple retrievals of the same 
data can be avoided. A translated or translatable query must be available. 



Usage 



dtt table_name key_columns 



where : 

1. table_name 

is the name of the temporary table. Subsequent references to this table 
must use this name. If a temporary table of this name already exists, it 
is redefined. This name may be from 1 to 32 characters long, must begin 
with an alphabetical character, and may be composed of alphanumeric 
characters plus the underscore (_) and the hyphen (-). 



8/86 



5-17 



AZ49-03A 



define temp__table 



def ine__teinp table 



2. 



key__colurnns 



are one or more column names specified in the associated select clause 
that become key columns in the temporary table. Key columns uniquely 
determine the rows of the temporary table ; that is , the concatenation of 
the values of all key columns must be unique for each row of the temporary 
table. Duplicates are automatically eliminated. 



The select clause of a query associated with a def ine__terap_table request cannot 
contain an expression. Only column names ( qual if led or unqual if led , including *) are 
allowed . 



All key columns must be explicitly specified in the associated select clause; 
that is , a key column cannot be one of those specified by a * . The order of the columns 
in the key of the temporary table is the order in which they appear in the select 
clause, not the order in the def ine__temp_table request. 



Temporary tables cannot be updated, but can be accessed for retrieval only. 
Temporary tables that do not have any tuples may be created. Normally, a temporary 
table is created for the purpose of simplifying queries when data is to be selected 
from several tables in the data base. 



If it is necessary to retrieve employee information from the department store 
data base depending upon the floor on which the employees are located, then a temporary 
table could be useful. 

emp_loc (name, emp_no, mgr, sal, coram, floor) 

The data for such a temporary table could be specified using the following query: 

linus: input__query -force 
Query: 

select emp.name emp.emp__no emp.mgr emp.sal 

emp. coram loc. floor 
from emp loc 

where emp.dept = loc.dept 



The table is then created with the request: 

linus: def ine__temp__table emp_loc name 

The query necessary to find the average salary of all employees located on the second 
floor would be: 

linus: input__query -force 
Query: 

avg {select sal 



Notes 



Examples 



from emp_loc 
where floor = 2} 



as opposed to the following, if the temporary table were not available: 
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d e f i n e__t emp__t a b 1 e 



clel_scope 



linus: input_query -force 
Query: 

avg {select sal 
from emp 

where dept = {select dept 



Request: del__scope, ds 



This request deletes all or a portion of the scope of access previously declared 
with a set_scope request, and is applicable only for shared (nonexclusive) opening 
modes . As an active request , it returns "true" if the scope is deleted and "false" if 
the delete scope fails. 



ds table__name2 {permit_opsJ[ prevent_opsJ[ table_naraeri permit_opsn 

prevent_ops£} 

Usage as an Active Request 

[ds table-name^ {parmit_opsJ[ prevent_ops2 ••• table_naraeri 
permit_opsri prevent_opsri} ] 

where: 

1. table namei 



is the name of a nontemporary table within the data base for which all or a 
portion of the scope of access is to be deleted. If table_name2 is a * , 
then no additional arguments need be specified, and all of the user's 
current access scope is deleted, even if none is set. 



2. permit_opsj. 

is a character string indicating which currently permitted operations 
are to be deleted from the access scope. 



3. prevent_opsj. 

is a character string indicating which of the operations currently being 
prevented for other processes can be deleted from the access scope. 



The null operation is ignored for delete scope. 

See the set_scope request for a definition of the operation codes and for a 
detailed discussion of the scope mechanism. 



from loc 
where floor = 2}} 



Usage 



Note 
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del__scope 



delete 



Examples 

Do not change permission for the employee table but allow other processes to 
perform store, modify, and delete operations. 

linus: del__scope emp n smd 

Delete all of the current scope of access. 

linus: del__scope * 



Request: delete, dl 



This request deletes selected rows from a single table within the data base. The 
data base must be open for update or exclusive__update and, if open for update, the 
affected table must be within the scope of access for delete. A translated or 
translatable query must be available. 



Usage 



dl 



Note 



The select clause of the associated query must specify columns from only one 
table and all columns from that table must be specified (use of • is recommended) . The 
query must not contain any set operators (union, inter, or differ). The affected 
table cannot be a temporary table. 



Example 

Joe Smith has retired. Delete his employee record. The query would be: 

Linus: input_query 
Query: 
select * 
from emp 

where name = "Joe Smith" 



The deletion is then accomplished via the request: 
linus: delete 
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cielete__teinp_table 



display 



Request: delete__teinp_table, dltt 



This request is used to delete temporary relations created for the current data 
base opening by the def ine__tenip__table request. 



Usage 



dltt temp_table_naine 



where temp_table_name is a table name which has successfully been used in a 
def ine_temp__table request since the last successful open request. 



Request: display, di 



This request retrieves selected data, creates a report, and displays it on the 
terminal or sends it to a file or an io switch. A translated or translatable query must 
be available. 



Usage 



di {-control_args} 



where control_args can be chosen from: 

Note: The following list identifies all control arguments grouped by 
function. The argument descriptions are listed alphabetically, 
immediately after the function groupings. 



CONTROLLING WARNING MESSAGES 
-brief, -bf 
-long, -Ig 

DISPLAYING PAGES AND PORTIONS OF PAGES 
-all, -a 

-character_positions , -chpsn 
-page, -pg 

DATA RETRIEVAL INITIATION AND TERMINATION 
-discard_retrieval , -dsr 
-keep_retrieval , -kr 
-new_retrieval , -nr 
-old_retrieval , -or 

REPORT INITIATION AND TERMINATION 
-discard_report , -dsrp 
-keep_report , -krp 
-new_report, -nrp 
-old_report, -orp 
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display 



display 



SORTING RETRIEVED DATA 
-sort 

CONTROLLING REPORT OUTPUT 
-extend 

-output__f ile, -of 
-output_switch, -osw 
-truncate, -tc 

VIDEO SYSTEM SCROLLING FUNCTIONS 
-erjable_e3cape_key3 , -eek 
-enable_function_keys , -efk 
-scroll 
-set_key, -sk 
-window, -win 

MULTI-PASS REPORT FORMATTING 
-passes, -pass 

TEMPORARY STORAGE SPECIFICATION 
-temp__dir, -td 



displays all pages of the report. This argument is incompatible with the 
-pages control argument. (Default) 

-brief, -bf 

suppresses warning messages. 

-character_positions STRl {STR2}, -chpsn STR1 {STR2} 

where STRl and STR2 define the left and right character positions of a 
vertical section of the report. STRl must be given and defines the left 
margin position to begin from. STR2 is optional, and if not given, 
defaults to the rightmost character position of the report. If this 
control argument is not given, the entire page is displayed. 

-discard_report , -dsrp 

deletes the report on termination. (Default) 

-discard__retrieval , -dsr 

deletes retrieved data on termination. (Default) 

-enable_escape_keys , -eek 

specifies the use of escape key sequences for scrolling functions, rather 
than the function keys and arrow keys on the terminal. This is the 
default if the -scroll control argument is given and the terminal does not 
have the necessary set of function keys and arrow keys (see 
-enable__function_keys) . (In the following description, the mnemonic 
"esc-" means the escape key on the terminal.) The following escape key 
sequences are used if this control argument is given, or the terminal 
lacks the necessary set of keys: 



-all, -a 



Function Name 



Key Sequence 



forward 
backward 



esc-f 
esc-b 
esc-1 
esc-r 
esc-? 
esc-k 
esc-i 



left 

right 

help 



set_key 

set_scroll_increment 

nil 1 1- 
-i — — " 



red isplay 

start_of_report 

end__of_report 



esc-d 
esc-s 
esc-e 
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display 



display 



multics_mode 
goto 



esc-m 
esc-g 



-enable_function_keys , -efk 

specifies the use of terminal function keys and arrow keys for scrolling 
functions. This is the default when the -scroll control argument is 
given and the terminal has at least nine function keys and four arrow 
keys. (In the following description , the mnemonic fN means function key 
N, where N is the number of the function key. The mnemonic down_arrow 
means the down arrow key, up__arrow means the up arrow key, left_arrow 
means the left arrow key, and right__arrow means the right arrow key. The 
following key sequences are used if this control argument is given and the 
terminal has the necessary set of keys: 



-extend 

appends the report to an existing file rather than replacing it if the 
-output_file control argument is used. (If this control argument is not 
provided, the default is to truncate an existing file.) 

-keep_report , -krp 

keeps the report on termination. This control argument is necessary in 
order to use -old_report on subsequent invocations of display. 

-keep_retrieval , -kr 

keeps retrieved data to allow re-use on subsequent invocations of the 
display request. Previously retrieved sorted data retains the sort 
order . 

-long, -Ig 

displays warning messages when a control argument such as -old_retrieval 
is used and the data from a previous retrieval is not available. 

(Default) 

-new_report, -nrp 

creates a new report. (Default) 

-new_retrieval , -nr 

begins a new retrieval from ^e data base. (Default) 

-old_report, -orp 

uses the report created in the previous invocation, use of this control 
argument requires that -keep__report be used in the prior invocation of 
display. 

-old_retrieval , -or 

uses data retrieved during the previous invocation. Use of this control 
argument requires that -keep_retrieval be used in the prior invocation of 
display. 



Function Name 



Key Sequence 



forward 

backward 

left 

right 

help 

set__key 

set__scroll__increment 
quit 

redisplay 

start_of_report 

end_of_report 

multics_mode 

goto 



down_arrow 
up_arrow 
left_arrow 
right_arrow 
f1 (function key) 



f2 
f3 
f4 
f5 
f6 
f7 
f8 
f9 



8/86 



5-23 



AZ49-03A 



display 



display 



-output_file path, -of path 

where path is the name of the file which contains the formatted report. 
If this control argument or -output_swi tch is not given, the report is 
displayed on the terminal. This argument is incompatible with the 
-output_switch control argument. 

-output_swi tch switch_narae, -osw switch_name 

where switch_narae is the name of a switch to be used to display the report . 
If this control argument or -output_file is not given, the report is 
displayed on the terminal. It is an error to. use this control argument if 
the named switch is not already open and attached when display is invoked . 
This argument is incompatible with the -output__f ile control argument. 

-page STR, -pg STR 

-pages STR, -pgs STR 

where STR is a blank-separated list of pages (N M) or comma-separated page 
ranges (N,N). Page ranges can also be given as N, or "N, $" which means 
from page N to the end of the report , or simply $ which means the last page. 
This argument is incompatible with the -all control argument. 

-passes N, -pass N 

where N is the number of times the report is to be formatted . No output is 
produced until the last formatting pass of the report. (Default value 
for N is 1) 



specifies scrolling the report according to key sequences read from the 
terminal. Only terminals supported by the Multics video system can use 
the scrolling feature. If the -window control argument is not used, 
create a uniquely named window for the display of the report. The 
user_i/o window is reduced to four lines and the remaining lines are used 
for the uniquely named report display window. The minimum size for this 
window is five lines, so the user_i/o window must be at least nine lines 
before invoking display, unless the -window control argument is used. 

-set_key STR, -sk STR 

-set_keys STR -sks STR 

specifies that the named scrolling functions are to be set to the provided 
key sequences. STR is a blank-separated list of one or more scrolling 
function names and key sequences, given as "function_name key_sequence 
... { function_name key_sequence} " . The function names can be chosen 
from the set described under -enable_escape__keys or 
-enable__function_keys control arguments. The key sequences can be given 
as the actual sequences or mnemonic key sequences. The provided 
mnemonics can be: 



-scroll 



fN 



where N is the number of the desired 
function key 



esc- or escape- 



corresponds to the escape character 



ctl-x or control-x 



corresponds to the character sequence 
generated when the control key is held 
while also pressing the character named by 

"X" 



down arrow 



corresponds to the down arrow key 



up_arrow 



corresponds to the up arrow key 



left arrow 



corresponds to the left arrow key 



right arrow 



corresponds to the right arrow key 



home 



corresponds to the home key 
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display 



display_builtins 



•sort STRs {-ascending I -descending} {-case sensitive I 

-non_case__sensitive} , -sort STRs T-asc 1 -dsc} {-cs I -ncs} 
where STRs are the names of columns as defined in the open model/submodel , 
or numbers corresponding to the position of the columns in the selection 
expression. It can be followed by -ascending or -descending, and 
-case__sensitive or -non_case__sensitive. (Default is -ascending and 
-case__sensitive. ) 

-temp__dir dir__name, -td dir_name 

specifies that the given directory be used for storing the retrieved 
data, saving the report if -keep__report is used, and sorting workspace if 
-sort is used instead of the process directory. This temporary directory 
continues to be used until another new temporary directory is requested. 
A new temporary directory can only be specified when a new retrieval and 
new report are requested. 

-truncate, -tc 

replaces the contents of the existing file if the ~output_file control 
argument is used. (If the -extend control argument is not provided, the 
default is to truncate.) 

-window STR, -win STR 

specifies that the window named by STR be used for the display of the 
report. This argument is only meaningful when the -scroll argument is 
also used. If this control argument is used, the window named by STR must 
be attached and open under the video system, and it must be at least five 
lines high. 



Examples 



display 

display -output_file foo 

display -keep_retrieval -sort bar -descending -non_case_sensitive 
display -keep__retrieval -keep_report -of fool -character__positions 1 132 
display -old_retrieval -old_report -of foo2 -character_positions 133 260 
display -pages 1 3 12,19 58,$ -output_switch foo 
display -sort foo -descending bar -non case sensitive 



Request: display__builtiDS, dib 



This request returns the current value of the built-in named by STR. It can only 
be used as an active request. It is used within a formatted report produced by the 
display request to obtain the current value of the specified built=in. It is an error 
to use this request anywhere except in a header/footer or editing string within a 
report produced by the display request. 



Usage as an Active Request 

[dib STR] 
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display_builtins 



do 



where STR can be any one of the following built-ins: 

current_pass_number 

the number of the current pass. The number begins with 1 and is 
incremented by 1 for each additional formatting pass over the report. 

curren t__row__n umber 

the number of the current row of the report i 

first row 

true if the current row is the first row of the report, or false if it is 
not the first row of the report* 

1 as t__pa g e__n um be r 

the number of the last page of the report, or "0" if it is the first pass 
over the report. After each formatting pass, the number is updated with 
the number of the last p^ge. 

last__pass 

true if this is the last formatting pass of the report, or false if this is 
not the last pass of the report. 

last__row 

true if the current row is the last row of the report, or false if the 
current row is not the last row of the report. 

last_row_number 

the number of the last rowof the table , or "0" if it is the first pass over 
the report. After the first formatting pass the number is set to the 
number of the last row. 

pa ge_n umber 

the number of the current page of the report. 

previously__processed__row 

true if the current row was processed on the preceding page but the row 
value would hot fit and h3id to be deferred to the current page, or false if 
this is the first time the current row is being processed. 



Request: do 



This request expands a request line by substituting the supplied arguments into 
the line before execution. As an active request, it returns the expanded 
reque3t__string rather than executing it. 



Usage 



do request_String {args} 

or : 



do -control__args 
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do do 

Usage as an Active Request; 

[do "request_string" args] 
where: 

1. request_string 

is a request line in quotes. 

2. args 

are character string arguments that replace parameters in 
request_string . 

3. control_args 

can be chosen from the following to set the mode of operation: 

-absentee 

establishes an any_other handler that catches all conditions and aborts 
execution of the request line without aborting the process. 

-brief, -bf 

specifies that the expanded request line not be printed before execution. 
(Default) 

-go 

specifies that the expanded request line be passed on for execution, 
(Default) 

-interactive 

specifies that the any_other handler not be established. (Default) 
= long, -Ig , , 

displays' the expanded request line before execution. 

-nogo 

specifies that the expanded request line not be passed on for execution. 
List of Parameters 

Any sequence beginning with & in the request line is expanded by the do request 
using the arguments given on the request line. 

&I 

is replaced by argl. I must be a digit from 1 to 9. 
&(I) 

is replaced by argl. I may be any value. 

&ql 

is replaced by argl with any quotes in argl doubled . I must be a digit from 1 
to 9. 

&q(I) 

is replaced by argl with any quotes in argl doubled. I may be any value. 

&rl 

is replaced by argl surrounded by level quotes with any contained quotes 
doubled. I must be a digit from 1 to 9. 
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do exec com 



&r(I) 

is replaced by a requoted argl. I may be any value. 

&fl 

is replaced by all the arguments starting with argl. I must be a digit from 
1 to 9. 

&f(I) . 

is replaced by all the arguments starting with argl. I may be any value. 
&qfl 

is replaced by all the arguments starting with argl with any quotes doubled . 
I must be a digit from 1 to 9. 

&qf(I) 

is replaced by all the arguments starting with argl with quotes doubled. I 
may be any value. 

&rl 

is replaced by all the arguments starting with argl. Each argument is 
placed in level quotes with contained quotes doubled. I must be a digit 
from 1 to 9. 

&rf(I) 

is replaced by all the arguments starting with argl, requoted . I may be any 
value . 

&& 

is replaced by an ampersand. 

&! 

is replaced by a 15-character unique string. The string used is the same in 
every place where the &! appears in the request line. 

&n 

is replaced by the actual number of arguments supplied. 
&f&n 

is replaced by the last argument supplied. 



Request: exec^cooi, ec 

This request executes a program written in the exec_com language that is used to 
pass request lines to linus and to pass input lines to requests that read input. As an 
active request, it specifies a return value by use of the &return statement. 



Usage 

ec ec^path {ec__args} 

U sage as an Active ReQuest 
[ec ec__path {ec_args}3 
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exec_c6m execute 
where: 

1. ec_path 

is the pathname of an exec_coni program. An lec suffix is assumed if not 
specified . 

2. ec__args 

are optional arguments to the exeG_com program and are substituted for 
parameter references in the program such as &1 . 



Notes 

For a description of the exec__com language (both Version 1 and Version 2), type: 
help vlec v2ec 

When evaluating a linus exec_com program, linus active requests are used rather 
than Multics active functions to evaluate the &[...] construct and the active string 
in an &if statement. The execute active request of linus can be used to evaluate 
Multics active strings within the exec_com. Refer to Section 7 for a description of 
how to write a linus exec com. 



Request: execute, e 

This request executes the supplied line as a Multics command line. As an active 
request, it evaluates a Multics active string and returns the result to the subsystem 
request processor. 



Usage 

e STR 

Usage as an Active Request 
[e STR] 

where STR is the Multics command line to be executed or the Multics active string 
to be evaluated. It need not be enclosed in quotes. 



Notes 

The recommended method to execute a Multics command line from within a subsystem 
is the escape sequence. The execute request is intended as a means of passing 

information from the subsystem to the Multics command processor. 
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execute 



format line 



All (), [], and "s in the given line are processed by the subsystem request 
processor and not the Multics command processor. This permits passing values of 
subsystem active requests to Multics commands when using the execute request, or 
passing values to Multics active functions for further manipulation before returning 
the values to the subsystem request processor for use within a request line. 



Examples 



The linus request line: 

[execute max [column_value salary] [column__value commission]] 

could be used as an editing request within a formatted report to return the largest 
value of the salary and commission columns. 

The linus request line: 

set format_options -page_header_value 

Texecute copy_character s - [ list_forraat_options -page_wid th] ] 

could be used to set the page header to a line of hyphens which is the same width as the 
page width. 



Request: fornat_line, fl 



This request returns a single, quoted character string that is formatted from an 
ioa__ control string and other optional arguments. 



Usage 



fl control__string {args} 



Usage as an Active Request 



[fl control__string targs}] 



where: 

1. control__string 

is an ioa_ control string used to format the return value of the active 
function. See "Notes" below. 

2. args 

are character strings substituted in the formatted return value, 
according to the ioa__ control string. 
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format line 



format line 



Notes 



The following ioa_ control codes are allowed (refer to "ioa_" in the Subroutines 
Manual for additional detail): 



Control Function 



"a 


"Na 


edit a character string in ASCII 


"d 


"Nd 


edit a fixed-point number 


"e 


"Ne 


edit a floating-point number in exponential form 


"f 


"Nf "N.Df ".Df 


edit a floating-point number 


"i 


"Ni 


edit a fixed-point number (same as "d) 


"o 


"No 


edit a fixed-point number in octal 


"s 


"Ns 


skip argument 


"[ 




start an if/then/else or case select group 


"] 




limit the scope of a "[ 


"( 


"N( 


start an iteration loop . 






end an iteration loop 




"N; 


used as a clause delimiter between "[ and "] 



In addition, any of the following carriage movement controls can be used: 
"N/ "N I "N- "Nx "N" "R "B 

or 

/ I - X 

where N is an integer count or a "v". When "v" is given, an integer character string 
from the args is used for count. (For a complete description of these control strings 
see "ioa " in the Subroutines Manual.) 



If no optional arguments are given, the value returned depends on the specified 
ioa_ control string. 



Examples 



In a formatted report the editing request: 

[format__line "Height"-Weight"/"a"- "a" Ccolumn_value height] [column_value weight]] 

might be expanded to return the string: 

Height Weight 
6.1 175 



The report editing request: 

[format_line ""[Senior Citizen Discount" ; Regular Discount"]" 

would be expanded to return the string: 

Senior Citizen Discount 
if the value of the age column was greater than 60. 
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help 



help 



Request: help 

This request displays information about linus topics including detailed 
descriptions of linus requests. 



Usage 



help {topics} {-control_args} 



where : 

1. topics 

specifies the topics on which information is to be displayed. The topics 
available within linus can be determined by using the list_help request. 

2. control__args 

can be chosen from the following: 

-brief, -bf 

displays a summary of a request or active request, including the syntax, 
list of arguments, control arguments, etc. 

-search STRs , -srh STRs 

displays the paragraph containing all the strings identified by STRs. 
(Default, the display begins at the top of the information.) 

-section STRs , -sen STRs 

displays the section whose title contains all the strings identified by 
STRs. (Default, the display begins at the top of the information.) 

-title 

displays section titles and section line counts, then asks if the user 
wants to see the first paragraph of information. 



List of Responses 



The most useful responses that can be given to questions asked by the help request 

are: 



displays "help" to identify the current interactive environment. 
.. command_line 

treats the remainder of the response as a Multics command line. 

7 

displays a list of responses allowed, 
no , n 

stops display of information and proceeds to the next topic, if any. 
quit, q 

stops display of information and returns to subsystem request level. 

rest {-section} , r {-sen} 

displays remaining information without intervening questions. If 
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help 



if 



-section is given, help displays the rest of the current section, without 
questions, and then asks if the user wants to see the next section. 

search {STRs} {-top}, srh {STRs} {-t} 

skips to the next paragraph containing all the strings identified by STRs. 
If -top is given, searching starts at the top of the information. If STRs 
are omitted, help uses the STRs from the previous search response, or the 
-search control argument. 

section {STRs} {-top}, sen {STRs} {-t} 

skips to the next section whose title contains all the strings identified by 
STRs. If -top is given, title searching starts at the top of the 
information. If STRs are omitted, help uses the STRs from the previous 
section response, or the -section control argument. 

skip {-section}} {-seen}, s {-sen} {-seen} 

skips to the next paragraph. If -section is given, the request skips all 
paragraphs of the current section . If -seen is given , the request skips to 
the next paragraph that the user has not seen . Only one control argument is 
allowed in each skip response. 

title {-top} 

displays titles and line counts of the sections that follow. If -top is 
given, help displays all section titles and repeats the previous question 
after titles are displayed. 

yes, y 

prints the next paragraph of information on this topic. 



Notes 



If no topic names are given, the help request explains what help requests are 
available in the subsystem. 



For a complete description of the control arguments and responses accepted by 
this request, type: 

help help 



Request: if 



This request conditionally executes one of two request lines depending on the 
value of an active string. As an active request, it returns one of two character 
strings to the subsystem request processor depending on the value of an active string. 



Usage 



if expr -then linel {-else line2} 
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if 



input__query 



Usage as an Active Request 



[if expr -then STR1 {-else STR2}] 



where : 



1. 



expr 



evaluates the active string as "true" or "false." The active string is 
constructed from subsystem active requests and Multics active strings 
(using the execute active request of the subsystem). 



2. 



line 1 



executes the subsystem request line if expr is "true." If the request 
line contains any request processor characters, it must be enclosed in 
quotes . 



3. 



Iine2 



executes the subsystem request line if expr is "false." If omitted and 
expr is "false," no additional request line is executed. If the request 
line contains any request processor characters, it must be enclosed in 
quotes . 



4. STRl 

returns this value to the active request when expr is "true." 

5. STR2 

returns this value to the if active request when expr is "false." If 
omitted and the expr is "false," a null string is returned. 



Request: lnput_query, iq 



This request collects a query and makes it available for linus data manipulation 
requests . 



-brief, -bf 

specifies that the prompt "Query:" be suppressed when the query is 
entered from the terminal. 

-force, -fc 

specifies that the existing query be replaced . If a query exists and this 
control argument is not used, the user is asked if the existing query 
should be replaced. A negative response terminates the invocation of 
input__query. 

-input_file path, -if path 

specifies that the query be taken from the file named by path. If path 
does not contain the Iquery suffix, it is assumed. 



Usage 



iq l-control__args} 



where control args can be chosen from the following: 
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input_query 



list db 



-long, -Ig 

specifies that the prompt "Query;" be displayed when the query is input 
from the terminal. (Default) 

-no__force, -nfc 

if a query exists , the user is asked if it should be replaced . (Default) A 
negative response terminates the invocation of input_query. 

-terminal_input , -ti 

specifies that the query be read from the .terminal . (Default) A line 
consisting of only the single character terminates the input. 

Typing "\q" anywhere on a line also terminates the input. Typing "\f" 
anywhere on a line terminates the input and enters the user directly into 
the qedx editor with the query. 



Example 



input__query -if query__file -fc 

input_ query 

Query: 

select * from sales 



Refer to Section 1 for examples of query statements 



Request: list_db, Idb 



This request lists information about the data base that is currently open. 
Information which can be listed includes the pathname of the data base, the opening 
mode , table names , column names , and detailed information about each table and column . 
Information for both temporary and permanent tables is provided. 



Usage 



Idb {-control__args} 
where control__args can be chosen from the following: 
-long, -Ig 

specifies that all available information about columns is to be listed. 
This includes the name of the domain from which column values are derived 
and the PL/I -like declaration for this domain. 

-names 

specifies that only table and column names are to be listed, 
-pathname, -pn 

specifies that only the pathname of the data base, together with the 
opening mode, is to be listed. 

-perm 

specifies that information pertaining only to tables that are a permanent 
part of the data base is to be listed. 
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list db 



list db 



-table_names 

specifies that only table names are to be listed. 

-table STR, -tb STR 

specifies that information pertaining only to tables named in STR is to be 
listed. STR is a list of permanent or temporary table names. 

-temp 

specifies that information pertaining only to temporary tables is to be 
listed. 



If no control arguments are specified, -pathname and -table__names are assumed. 
If -table, -temp, or -perm is not specified, then information for all permanent and 
temporary tables is supplied. 



If -table is specified, all other controls except -long and -pathname are 
ignored. 



Only one of the following may be chosen: 



For non-DBA users of secure data bases (see the MRDS manual for the definitions of 
DBA and secured data bases) , the following format changes will be seen because of 
possible security leaks: 



1. Domain names will not be displayed. 

2. Columns comprising the key of the table will not be shown as "key" columns. 
The first column in the key will be displayed as "index All other columns 
will be shown as "data." 



Examples 



List the data base pathname and opening mode. 

linus: list__db -pathname 

>udd>Demo>dbmt>db>dept__store 

update 



List the names of all currently defined temporary tables, 
linus: list_db -temp -table__names 



Notes 



-table_names 

-names 

-long 



TABLE 
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list f6rmat_options list__format_options 



Request: list__format__options, Isfo 



This request lists the names and values of individual report formatting options, 
all report formatting options, or the active report formatting options. As an active 
request, it returns the value of the single specified format option. 



Usage 



Isfo -control_arg 

or : 

Isfo -format_option_args 



Usage as an Active Request 



[Isfo -format_option_arg] 



where: 

1. control_args 

can be chosen from the following: 

-active, -act 

specifies that only the active formatting options are to be listed. 
(Default) "help formatting_options .gi" is typed for more information on 
active formatting options. This control argument is incompatible with 
-all and the format option arguments . If -active and -all are both given , 
the last one supplied is used. 

-all, -a 

specifies that all formatting options are to be listed. This control 
argument is incompatible with -active and the format option arguments. 
If -all and -active are both given, the last one supplied is used. 

2. format__option_args 

can be one or more of the following: 



Note: The following list identifies all format option 
arguments grouped by function. The argument 
descriptions are listed alphabetically, immediately 
after the function groupings. 



GENERAL REPORT OPTIONS 
-delimiter, -dm 

-format__document_controls . -fdc 
-hyphenation, -hph 
-page_footer_value , -pfv 
-page_header_value , -phv 
-page_length, -pi 
-page_width, -pw 
-ti tle__line, -tl 
-truncation, -tc 
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list__fofmat_options list foriBat__optlons 



GENERAL COLUMN OPTIONS 
-coluinn_order , -co 
-count, -ct 
-exclude, -ex 
-group, -gr 

-group_footer__trigger , -gft 
-group__footer_value , -gfv 
-group__header_trigger , -ght 
-group_^header^value , -ghv 
"Outline, -out 
-page__break, -pb 
-row__footer__value , -rfv 
-row_header__value , -rhv 
-subcount, -set 
-subtotal, -stt 
-total , -tt 

SPECIFIC COLUMN OPTIONS 
-alignment, ^al 
-editing, -ed 
-folding, -fold 
-separator, -sep 
-title, -ttl 
-width, -wid 

-alignment column_id, -al column__id 

displays the alignment mode within the display width for the specified 
column. (Also see "Notes".) 

-coluran__order , -co 

displays the order of columns in the detail line. 

-count, -ct 

displays the columns which have counts taken on them, 
-delimiter, -dm 

displays the character used to delimit the different portions of a header 
or footer . 

-editing colirain_^id, -ed column_id 

displays the editing string for the specified column. (Also see 
"Notes".) 

-exclude, -ex 

displays the columns to be excluded in the detail line. 

-folding column__id, -fold column__id 

displays the folding action taken when the column value exceeds the 
display width for the specified column. (Also see "Notes".) 

-format__document_controls , -fdc 

displays the interpretation of embedded format document controls when 
filling (on), or the treatment of embedded controls as ordinary text 
(off) . 

-group, -gr 

displays the columns usied to group a number of rows based on their values. 

-group__footer__trigger , -gft 

displays the columns which can cause the generation of the group footer. 

-group footer value, -gfv 

dTsplays~the group footer placed after each group of rows. 
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list format options list_format options 



-group_header_trigger , -ght 

displays the columns which can cause the generation of the group header. 

-group_header_value , -ghv 

displays the group header placed before each group of rows. 

-hyphenation, -hph 

displays hyphenation where possible for overlength values (on), or no 
hyphenation (off). 

-outline, -cut 

displays the columns which can duplicate suppression. 

-page_break, -pb 

displays the columns which can cause a break to a new page. 

-page_footer_value , -pfv 

displays the page footer placed at the bottom of each page. 

-page_header_value , -phv 

displays the page header placed at the top of each page. 

-page__length, -pi 

displays the length of each formatted page given as the number of lines. 
-page__width , -pw 

displays the width of each formatted page given as the number of character 
positions . 

-row_footer_value , -rfv 

displays the row footer placed after each row value. 

-row_header_value , -rhv 

displays the row header placed before each row value. 

-separator column id, sep column id 

displays the'character string that separates the specified column from 
the column in the detail line which immediately follows it. (Also see 
"Notes".) 

-subcount, -set 

displays the columns that have subcounts taken on them. 

-subtotal , -stt 

displays the columns that have subtotals taken on them. 

-title column_id , -ttl column_id 

displays the character string that is placed at the top of the page above 
the specified column. (Also see "Notes".) 

-title_line, -tl 

displays printing of the title line (on) or the suppression of the title 
line (off) . 

-total , -tt 

displays the columns that have totals taken on them, 
-truncation, -tc 

displays the character or characters used to indicate truncation. 

-width column__id , -wid column__id 

displays the display width in the detail line for the specified column. 
(Also see "Notes".) 
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list__format_options list_help 



Notes 

The variable Golunin_id identifies the column name as defined in the open 
model/submodel, the number of the column in the query, or a star name which is matched 
against the column names. 

Refer to the description of the set_format_options request for a complete list of 
the default values for the format options and a discussion of their allowed values. 
When used as an active request, only one format__option__arg can be specified. 



Examples 

list_format__options 

list__format_options -all 

list__format__options -width 1 -alignment salary 

list_format__options -page__width -title *• -page__length 



Request: list_^help, Ih 

This request lists the names of all subsystem info segments pertaining to a given 
set of topics. 



Usage 

Ih {topics) 

where topics specifies the topics of interest. Any subsystem info segment that 
contains one of these topics as a substring is listed. 



Notes 

If no topics are given, all info segments available for the subsystem are 
displayed . 

An info segment name is considered to match a topic only if that topic is at the 
beginning or end of a word within the segment name. Words in info segment names are 
bounded by the beginning and end of the segment name and by the characters period ( .) , 
hyphen (-), underscore (__) , and dollar sign ($). the info suffix is not considered 
when matching topics. 
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list__help 



list__requests 



Examples 



The request line: 
list__help list 

matches info segments named list__values , list_scope, list_db, etc., but would not 
match an info segment named prelisting, if such a segment existed. 



Request: list__requests, Ir 

This request displays a brief description of selected subsystem requests. 



Usage 



Ir {STRs} {-control__args} 



where : 

1. STRs 

specifies the requests to be displayed. Any request with a name 
containing one of these strings is displayed unless -exact is used, in 
which case the request name must match exactly one of these strings. 

2. control_args 

can be chosen from the following: 

-all, -a 

includes undocumented and unimpleraented requests in the display of 
requests eligible for matching the STR arguments. 

-exact 

displays only those requests whose names match exactly one of the STR 
arguments. 



Notes 



If no STRs are given, all requests are displayed. 



A request name is considered to match a STR only if that STR is at the beginning or 
end of a word within the request name. Words in request names are bounded by the 
beginning and end of the request name and by the characters period (.), hyphen (-), 
underscore (_) , and dollar sign ($). 



Examples 



The request line: 

list__requests values 
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list__requests 



list values 



matches requests naaied list__values and assign__values , but does not match a request 
named column value. 



Request: list__scope. Is 

This request lists the current scope settings for permanent tables in the data 
base. As an active request, it returns the current scope settings. 



Usage 

Is {-control_argl 

Usage as an Active Request 
[Is {-control_arg} ] 

where control__arg can be -table name-J^ {. . . nameri} , or -tb name-l^ {• • • nameri} which 
specifies that scope settings for only the named tables are to be listed. If -table is 
not specified, scope settings are listed for every permanent table in the data base 
that is in the current scope of access. 

Examples 

List the current scope of access, 
linus: list_scope 

Table Permitted Prevented 

emp rm rsmd 

sales r n 

List the current scope of access for the sales and supply tables. 

linus: list__scope -table sales supply 

Table Permitted Prevented 

sales r n 

supply n n 



Request: list_values, Iv 



This request lists the values of the designated linus variables. For 
information on creating linus variables see the assign_values request in this 
section. As an active request, it returns the value assigned to the designated linus 
variable . 



8/86 



5-42 



AZ49-03A 



Ii3t__values Itrim 
Usage 

Iv {variable 1 ... variablen} 



Usage as an Active Request 
[Iv variable] 

where variable^, is one or more linus variable naraes (each name must begin with an 
exclamation point (!)). If this argument is omitted, then all existing linus 
variables are assumed to be the designated variables, and their values are displayed 
in the order that they were assigned their first values. Only one linus variable name 
can be supplied when used as an active request. 



Example 



linus: list_values abc 
abc = 123 



Request: Itrim 

This request returns a character string trimmed of specified characters on the 

left. 

Usage 

Itrim STRa {STRb} 

^fsage as Ac tive^ - R e qu est - 
[Itrim STRa {STRb}] 

Notes 

The Itrim command or active function, finds the first character of STRa not in 
STRb , trims the characters from STRa preceding this character , and returns the trimmed 
result. Space characters are trimmed if STRb is omitted. 
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Itrio 



modify 



Examples 



string Cltrim 000305.000 0] 
305. 000 

string [Itrim This is it. "] 
This is it. 



Request: aodify, ■ 



This request modifies selected data in the data base. The data base must be open 
for update or exclusive_update. If open for update, the table being updated must be 
within the current access scope for the modify operation , New values may be specified 
within the request line, or they may be entered interactively, in response to linus 
prompting. In both cases, the user is asked to verify the new values before the 
modification takes place, unless the -brief control argument is specified. A 
translated or translatable query must be available. 



Usage 



m { CO 1 urn n_ values} { -control_arg} 



where: 

1. column values 



are optional arguments and , if present , specify the new values that are to 
replace the current values of the data selected by the associated query. 
The column__values must be specified in the same order that the associated 
column names are listed in the select clause. If not present, linus 
requests the column__values individually by name. 



can be either -brief or -bf which specifies that verification of 
column__values is not to be done. If not present, linus displays a list of 
selected column names, together with the column__values as entered by the 
user, and requests that the user verify the correctness of the 
column__values before the modification operation proceeds. If the 
verification is negative , the modification does not take place . The user 
may reenter the modify request without again specifying the associated 
query. 



New column__values may be specified in two forms: 1) as constants or linus 
variables which have previously been set, or 2) as arithmetic expressions combining 
constants, linus variables, and possibly the name of the column being modified. All 
arithmetic expressions must be enclosed in parentheses . Any character string values 
entered via the request line and containing embedded white space must be enclosed in 
quotes . 



The select clause of the associated query must specify columns from only one 
table, and only nonkey columns maybe selected. The select clause associated with a 



2. 



control_arg 



Notes 
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modify 



modify request may not contain arithmetic expressions, but is restricted to simple or 
qualified column names. Also, no set operators (union, inter, or differ) may appear 
in the query. The null character string ( "") may be used only when modifying the data 
types : 

character 
character varying 
bit varying 



Examples 



Give every employee a 10 percent raise. The query is: 

linus: input__ query 
Query: 
select sal 
from emp 



The modification is accomplished when iteration is on by: 

linus: modify "(sal + . 10 * sal)" 

sal = (sal + . 10 * sal) 
OK? yes 



Al Jones has transferred to the shoe department. Update his employee record to 
indicate his new department and manager. The query is: 

linus: input_query 
Query: 

select dept mgr 
from emp 

where name = "Al Jones" 



The modification may be specified by: 

linus: modify 

dept? Shoe 
mgr? 1234 

dept = Shoe 
mgr = 1234 
OK? yes 



Update the data base to indicate that the shoe department has moved to the third 
floor. The query is: 

linus: input_ query 
Query: 

select floor 
from loc 

where dept = "Shoe" 
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modify 



Open 



The modification may be specified by: 
linus: modify 3 -brief 



Request: open, o 



opening mode. The data base may be designated either by the pathname of the data base 
itself, or by the pathname of a data submodel associated with the data base. Only one 
data base may be open at any given time. As an active function, it returns "true" if 
the data base was successfully opened and "false" if it was not opened. 



Usage 

o path mode 



Usage as an Active Request 
to path mode] 



where : 
1. path 



2. mode 



is the pathname of an MRDS data base or of a data submodel associated with 
an MRDS data base. A data submodel is a user ' s view of the data base which 
may differ from the actual data base definition. See the MRDS Manual for 
a detailed discussion of data models and data submodels. 

is the usage mode for which the data base is to be opened. Modes can be 
specified either by their full names or by their abbreviations. 



exclusive__retrieval , er 

indicates that the user wishes only to retrieve data from the data base, 
but that concurrent access by other users for update is to be prohibited. 

exclusive_update , eu 

indicates that the user wishes to both retrieve and update information in 
the data base and that no concurrent access by other users is to be 
permitted . 

retrieval, r 

indicates that the user wishes only to retrieve data from the data base 
and allows concurrent access, for both update and retrieval, by other 
users. This mode requires that the user set scope for all tables to be 
touched (see the set__scope request). 

update, u 

indicates that the user wishes to both retrieve and update information in 
the data base and allows concurrent access, for both update and 
retrieval, b y o ther users. This mode r equ ires that the user set scops for 
all tables to be touched (see the set scope request). 
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open opened database 



Notes 

For secure data bases, non-DBA users will be required to use the pathname of a 
secure data submodel. Refer to the MRDS manual for definitions of DBA, secure data 
submodel, and secure data base. 

If the designated data base is already open by another user in a mode that 
conflicts with the mode designated in this open request, the open request is denied. 

Several data bases may be opened and closed during a linus session. However, 
only one data base may be open at any given time. 

Example 

Open the department store data base for nonexclusive retrieval, 
linus: open dept store retrieval 



Request: opened__database 

This request (without the optional path) , returns "true" if there is an open data 
base and "false" if there is no open data base. If path is provided, the request 
returns "true" if the specified mrds data base is currently open and "false" if the 
data base is not open. This request can only be used as an active request. 



Usage as an Active Request 
[odb {path}] 

where path is the pathname of a mrds data base or data submodel associated with a mrds 
data base. 



Example 



linus: string [ open ed__dat abase] 

false /* there is no currently open data base •/ 

linus: string [opened_database] 

true /* there is a currently open data base */ 

linus: string [opened__database foo] 

false /* the foo data base is not currently open */ 

linus: string [ open ed_dat abase foo] 

true /* the foo data base is currently open */ 
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picture 



print 



Request: picture, pic 



This request returns one or more values processed through a specified PL/I 
picture . 



Usage 



pic pic__string values {-control_arg} 



Usage as an Active Request 



[pic pic_string values I -control__arg} ] 



where: 

1. pic_string 

is a valid PL/I picture as defined in the PL/I Reference Manual and the 
PL/I Language Specification. 

2. values 

, are strings having data appropriate for editing into the picture. Each 
•value must be convertible to the type implied by the picture specified. 
If multiple values are presented, the results are separated by single 

.spaces. Any resulting value that contains a space is quoted. 

3. control__arg 

-strip 

removes leading spaces from edited picture values; removes trailing 
zeros following a decimal point; removes a decimal point if it is the last 
character of a returned value. 



Notes 

For more information on PL/I picture and picture strings, see the PL/I Reference 
Manual, (Order NO. AM83) or the PL/I Language Specification (Order No. AG94) 



Examples 



The editing request in a formatted report: 

[picture $99,999v.99 [ column_value salary]] 
returns the value $27,922.41 if the value of the salary column was 27922.41. 



Request: print, pr 



This request specifies that selected data is to be retrieved and displayed on the 
user's terminal. The selected columns are displayed side-by-side with optional 
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print 



print 



column headers. The user may specify that a limit be placed on the number of rows to be 
displayed. A translated or translatable query must be available. 



Usage 



pr {-control_args} 
where control args can be one or more of the following: 
-all, -a 

specifies that every row of information is to be displayed. The user is 
not queried. 

-col_widths wj[ . . . vin, -cw w^ • . • w£ 

explicitly specifies the width of each column to be displayed (in 
characters). If not present, the widths assume default values 
calculated from the data base definition of the items selected, or 
lengths of the column headers, whichever is larger. If this control 
argument is present, the specified widths must correspond in order and 
quantity to the items in the lila select clause. The column header is 
truncated if its length is greater than the column widths given. The wi 
may be integers or may be specified as "p.q" , where p and q are precision 
and scale, respectively, of numeric data. Asterisks are printed if 
retrieved data cannot be printed in the column widths specified. 

-col_wid ths_trunc , -cvi/t 

is identical to the -cw control argument except that truncation occurs in 
cases where retrieved data contains more characters than the column 
widths specified. This argument is not compatible with -col_widths. 

-max N 

where N is a positive integer specifying that no more than N rows of 
information are to be displayed. If there are more than N rows , the user 
is queried as to whether more information is desired. Allowed responses 
to this query are : yes , to continue printing data and query after N more 
data lines are printed; no, to stop printing; or all, to print all 
remaining data without query. If -max N is not given, N is set to 10. 
This argument is incompatible with -all. 

-no_end 

specifies that the string "(END)" is to be suppressed when there is no 
more data to be printed. 

-no_header, -nhe 

specifies that column headers are not to be displayed. If not present, 
column headers consisting of column names are displayed if columns are 
selected. If an expression is selected, the column header is f (name) , 
where name is the table or row designator name for the data base items 
appearing in the expression. 



Notes 



The columns are displayed side-by-side. The width of each column is determined 
from the data descriptions in the data base. Each column is separated from the next by 
two blanks. There is no pagination. 
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print 



qedx 



The current maximum total length for columns, two space separators, and trailing 
newline characters that make up the print line is 5000. 



Example 

Display the names of all employees in the shoe department, together with the sums 
of their salaries and commissions. The query is: 

linus: input__query 
Query: 

select name sal + comm 
from emp 

where dept = "Shoe" 

The retrieval is accomplished as follows: 

linus: print 

name F(emp) 

John Smith 10000 

Al Jones 12000 

Carol Anderson 8000 

Betty Johnson 11000 
(END) 



Request: print__query, pq 

This request prints (displays) or returns the current query, 



Usage 

pq 



Usage as an Active Request 
[pq] 



Request: qedx, qx 



This request invokes the qedx editor with the current query, or a new query. The 
edited query becomes the current query if the changes are saved before terminating 
qedx . 
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qedx report 
Usage 

qx { -control_args} 

where control_args can be chosen from the following: 
-new 

specifies that qedx be given an empty buffer when invoked. 

-old 

specifies that the existing query be made available for editing with 
qedx. (Default) 

Note 

The user must write (save) the changed query for it to become the current query. 



Request: quit, q 

This request terminates the linus session. If a data base is open at the time of 
this request, it is automatically closed. 



Usage 



Request: report, rpt 

- This request "spec^if^s that sets ciied- data "Ir^-i^o^^l^^ us^d tD^geTrer a t"e' 

a formatted report via the report_ I/O module and an existing Multics Report Program 
Generator (MRPG) object module. Refer to the MRPG Manual for a complete description 
of the MRPG facility. A translated or translatable query must be available when this 
request is specified. 



Usage 

rpt arg__string 

where arg_string is a character string that must begin with the name of the MRPG object 
module, and must also contain any arguments required by the MRPG object module. 
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report 
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Note 



The report is created by attaching the report file via report_ and opening it in 
stream_output mode. Each set of selected values is written as a line through report__. 
Within the MRPG program, the input from linus must be declared with the attribute, 
special . 



Create a formatted report containing the name, department, and salary of every 
employee. Assume that the MRPG object module, emp__report, creates the desired 
report. The query is: 

linus: input__query 
Query: 

select name dept sal 
from emp 



The report is created by the following request: 
linus: report emp__report 



Request: restore__forDat_optlons, rsfo 



This request restores the saved report layout specified by path. Only the 
formatting options found in the saved report layout have their values changed. 



where path is the pathname of the saved report format to be restored. If path does not 
have a fo.lec suffix, one is assumed. 



Refer to the save__format__options request for detail on the content of the saved 
report format. 



Example 



Usage 



rsfo path 



Hotes 



Examples 



restore_format__options sample__display__format 
restore__format_options another__display_format .fo .lec 
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save format__options 



Request: rtrim 



This request returns a character string trimmed of specified characters on the 



rtrim STRa {STRb} 

Usage as an Active Request 
[rtrim STRa iSTRb}] 

Notes 

The rtrim active function finds the last character of STRa not in STRb, trims the 
characters from STRa following this character, and returns the trimmed result. Space 
characters are trimmed if STRb is omitted. 

Examples 

string [rtrim 000305.000 0] 
000305. 

string [rtrim [Itrim 000305.000 0] 0] 
305. 

string X[rtrim " This is it. "]Y 
X This is it.Y 



-Reiiuest : --aa«e__f ormat^options , -svfo 




This request saves the current values of format options as a linus subsystem 
exec__com. The saved format can be restored with the restore_format_options request. 
The file is saved with a fo.lec suffix. Individual format options, active format 
options, or all of the format options can be saved. The query can also be saved. 



right . 



Usage 




Usage 



svfo path {-format_option_args} {-control_args} 



where: 
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1. path 

is the pathname of the segment that contains the saved format. If path 
does not have a fo.lec suffix, one is assumed. 

2. format_option_args 

refer to the 3et_format_options request for a complete description of the 
format option arguments. Each format option named has its value saved in 
the exec_cora specified by path. These arguments are incompatible with 
the -all and -active control arguments. 

GENERAL REPORT OPTIONS 

-delimiter, -dm 

-format_document_controls , -fdc 
-hyphenation, -hph 
-page_footer_value , -pfv 
-page_header_value , -phv 
-page__length , -pi 
-page__width , -pw 
-title_line, -tl 
-truncation, -tc 

GENERAL COLUMN OPTIONS 

-column__order , -co 
-count, -ct 
-exclude, -ex 
-group, -gr 

-group_footer_trigger , -gft 
-group__footer_value , -gfv 
-group__header_trigger , -ght 
-group_header__value , -ghv 
-outline, -out 
-page_break, -pb 
-row_footer_value , -rfv 
-row_header_value , -rhv 
-subcount, -set 
-subtotal, -stt 
-total, -tt 

SPECIFIC COLUMN OPTIONS 

-alignment, -al 
-editing, -ed 
-folding, -fold 
-separator, -sep 
-title, -ttl 
-width, -wid 

3. control__args 

can be one or more of the following: 

-active, -act 

specifies that only the active formatting options are to be saved. 
(Default) Type "help formatting__options .gi" for more information on 
active formatting options. This control argument is incompatible with 
the format option arguments and the -all control argument. If -active 
and -all are given, the last one supplied is used. (Default) 

-all, -a 

specifies that all formatting options are to be saved. This control 
argument is incompatible with the format option arguments and the -active 
control argument. If -all and -active are given, the last one supplied is 
used . 
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query 

specifies that the current query is to be saved. A 
restore_forinat_options on the saved format also restores and makes the 
saved query current. 



Examples 



save_ 


format^ 


options 


report^ 


layout 


save_ 


forma t_ 


options 


report_ 


layout 


save_ 


_format_ 


options 


report_ 


layout 


save_ 


format_ 


options 


report_ 


layout 


save_ 


forma t_ 


_options 


report_ 


layout 


save_ 


forma t_ 


options 


r eport_ 


layout 



-all 
-query 

-page_header__ value -page_footer_value 
-page_header_value -width salary 
-width ** -page_footer value 



Request: save_query, sq 

This request takes the current query and saves (writes) it to a file. 



Usage 

sq path 

where path is the name of the saved f ile . If not present , a suffix of 1 query is added to 
path . 



Request: set_format__options , sfo 



This requaaiL.js_et.s_indi.vid_u.aI report format opt ions t o user-speci fied or def ault 

values, and/or all formatting options to default values. 



Usage 

sfo {-format_option__args} {-control__args} 



NOTE: The option value given for any format option argument can be the control 
arguments -default or -prompt . If -def aul t is given for the value , 1 in us 
sets the value of the format option to the system default. If -prompt is 
given for the value, linus prompts for the value with the prompt string 
"Enter FORMAT_OPTION_NAME. " . A line consisting of the single character 
"." terminates the prompted input mode. To suppress display of the 
prompt string, use the -brief control argument. 
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where : 

1. format_option_args 

can be one or more of the following: 



Note: The following list identifies all format option 

arguments grouped by function. The argument 
descriptions are listed alphabetically, immediately 
after the function groupings. 



GENERAL REPORT OPTIONS 
-delimiter, -dm 

-format_document__controls, -fdc 
-hyphenation, -hph 
-page_footer_value , -pfv 
-page_header_yalue , -phv 
-page__length , -pi 
-page_width, -pw 
-title_line, -tl 
-truncation, -tc 

GENERAL COLUMN OPTIONS 
-column_order , -co 
-count, -ct 
-exclude, -ex 
-group, -gr 

-group_footer_trigger , -gft 
-group_footer_value , -gfv 
-group_header_trigger , -ght 
-group_header_value , -ghv 
-outline, -out 
-page_break, -pb 
-row_footer_value , -rfv 
-row_header_value , -rhv 
-subcount, -set 
-subtotal, -stt 
-total , -tt 

SPECIFIC COLUMN OPTIONS 
-alignment, -al 
-editing, -ed 
-folding, -fold 
-separator, -sep 
-title, -ttl 
-width, -wid 

-alignment column_id STR, -al column_id STR 

column_id (see "Notes") specifies which column the alignment applies to 
and STR is the alignment mode. STR can be set to center, left, right, 
both, or decimal N. The default value for STR depends upon the type of 
column selected. Character and bit strings default to left alignment, 
decimal data with a non-zero scale defaults to decimal point alignment, 
and all other types default to right alignment. For decimal alignment, 
the decimal alignment position within the display width is given a 
default value. This alignment position can be changed by specifying the 
value as "decimal N" , where N is the character position within the 
display width where the decimal point is aligned. The alignment mode 
"both" specifies that the column value is aligned to the leftmost and 
rightmost character positions within its display width. Text is padded 
by insertion of uniformly distributed whitespace if necessary. 

-column_order column_list, -co column_list 

coluran_list determines the order in which columns appear in the detail 
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line. column_list can be set to a list of column names or numbers. 
Columns missing from this list are placed after the columns which appear 
in the list . That is , if five columns were selected and the column_order 
value is given as "3 2", the complete order would be "3214 5". 
(Default value for coluran_list is the list of columns from the query, in 
the order supplied , meaning that the columns appear in the exact order as 
they appear in the query. 

-count column_list, -ct column_list 

column_list determines the columns for which counts are generated. 
column_list can be set to a list of column names or numbers. Counts are 
generated after the last detail line. If a count is requested on a column 
that is excluded , the count is also excluded from the page. An exception 
to this rule is when all columns are excluded. Counts are provided in 
this case to allow reports consisting of some combination of counts, 
subcounts, totals, and subtotals only. (Default value for column_list 
is meaning no columns have counts generated. 

-delimiter CHAR, -dm CHAR 

CHAR is the character used to delimit the different portions of a header 
or footer and can be set to any printable character. (Default value for 
CHAR is "!".) 

-editing column_id STR, -ed coluran_id STR 

STR specifies the additional editing to be done to the column value before 
it is placed on the page and column_id (see "Notes") specifies which 
column the editing applies to. Multics active functions and linus active 
requests are normally used to provide additional editing. For example, 
the editing value: 

[pic $99,999v.99 [column_value salary]] 

places commas and dollar signs in the "salary" column. (Default value 
for STR is "", meaning additional editing is not done.) 

Refer to the column_value request for a description of usage. 

-exclude column_list, -ex column_list 

column_list determines if any of the columns selected in the query are 
excluded from the detail line. column_list can be set to a list of column 
names or numbers. (Default value for column_list is "", meaning no 
columns are excluded.) 

-folding column_id STR, -fold column_id STR 

STR determines what type of action occurs when a column value exceeds its 
display width and column_id (see "Notes") specifies which column the 

X?J-^J-P--S-3-PPl isS--to_. STR set_.t-ii--^rajn_caJtei^,-m^afl-s tii# val-ue-o^ t^i^-eolrumfj- - 

is truncated to fit in the display width and the truncation character(s) 
is placed at the end of the value to indicate truncation occurred. 
(Default value for STR is "fill," meaning portions of the value which 
exceed the display width are moved down to the next line(s) until a 
correct fit is obtained.) 

-format_document_controls STR, -fdc STR 

STR determines if the format_document_ subroutine is to interpret format 
document control lines when filling overlength text. STR can be set to 
"on," meaning f"ormat_document_ interprets control lines in the text and 
provides special filling actions based on the embedded control lines. 
(Default value for STR is "off," meaning format_documen t_ does not check 
for control lines embedded in text.) 

-group column_list, -gr column_list 

column_list determines the grouping of a number of rows based on the 
values of one or more columns. column_list can be set to a list of column 
names or numbers. The column or columns named in the list become a 
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hierarchy of columns . The first column named is the major column , and the 
last column named becomes the minor column. The hierarchy of columns can 
be used with the outline, page_break, and subtotal options described 
below. (Default value for column_list is"", meaning no group of rows is 
defined . ) 

-group_footer_trigger column_list, -gft column_list 

column_list determines when to generate the group footer. column_list 
can be set to a list of column names or numbers. The columns which appear 
in this list must also appear in the column list associated with the 
-group option. If the -group option is set to a new value , columns which 
are eliminated from the coluran_list are also eliminated from the 
-group_footer__trigger column_list. When any of the columns specified in 
the column_list are about to change with the next row, the group footer is 
evaluated . The group footer is always evaluated after the last row of the 
report. (Default value for column_list is "", meaning no group footer 
triggers are defined.) 

-group_footer_value STR, -gfv STR 

STR is the group footer placed after each group of rows when any of the 
columns associated with the -group_footer_tr igger option changes. 
Refer to the description of -page_footer_value above for the content of a 
header/footer. (Default value for STR is "", meaning there is no group 
footer defined.) 

-group_header_trigger column_list, -ght column_list 

column_list determines when to generate the group header. column_list 
can be set to a list of column names or numbers. The columns which appear 
in this list must also appear in the column list associated with the 
-group option . If the -group option is set to a new value , columns which 
are eliminated from the column__list are also eliminated from the 
-group_header_trigger column_list. When any of the columns specified in 
the column_list have just changed with the current row, the group header 
is evaluated. The group header is always evaluated before the first row 
of the report. (Default value for column_llst is "", meaning no group 
header triggers are defined.) 

-group_header_value STR, -ghv STR 

STR is the group header placed before each group of rows when any of the 
columns associated with the -group_header_trigger option changes. 
Refer to the description of -page_footer_value above for the content of a 
header/footer. (Default value for STR is "", meaning there is no group 
header defined.) 

-hyphenation STR, -hph STR 

the value of -hyphenation determines if hyphenation is to be attempted 
when filling overlength character strings. STR can be set to "on," 
specifying that hyphenation is to be attempted. (Default value for STR 
is "off," meaning no hyphenation is attempted.) 

-outline column_list, -out coluran__list 

column__list determines if duplicate values in a column are to be 
suppressed. column_list can be set to a list of column names or numbers. 
If the value of a named column is the same as its previous value, then the 
value is suppressed unless it is the first line of a new page. (Default 
value for column_list is "", meaning no columns have duplicate values 
suppressed.) 

If any of the named columns are a member of the "group" of rows defined by 
the group option , then it , and all of the columns more major in this group , 
are outlined. A change in value of any one column displays all columns 
lower in the hierarchy in addition to the column that changed. An 
exception is the first line on a new page, in which case duplicate values 
are never suppressed. 
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-page_break colutnn_l ist , -pb coluain_list 

colutnn_list determines when page breaks are generated. columrj_list can 
be set to a list of column names or numbers. The columns specified in the 
list are examined, and when their values change, a new page break is 
generated . If any of the named columns are a member of the "group" of rows 
defined via the group option, then it, and all columns more major in the 
group, are examined for page breaks. (Default value for column_list is 
meaning that no columns are examined for page breaks.) 

-page_footer_value STR, -pfv STR 

STR is the page footer placed at the bottom of each page. The page footer 
can consist of more than one line, and each line can have a left, right, 
and center portion. The individual portions of each line are delimited 

by the delimiter character. Active requests found in the footer are 
evaluated and their return value is placed into the footer before folding 
and alignment takes place. Portions of a footer with zero length have 
their space on the page redistributed to the other portions whose lengths 
are not zero. For example, if the page footer contained only a center 
portion: 

!! Sample Center Portion!! 

the text is centered on the page and has the full page width available for 
the text. Similarly, a left portion or right portion only is aligned to 
the left or right of the page and has the full page width available for 
placement of text. Two exceptions to this action are when the footer has 
a left, right, and center portion, and the left or right portion has a zero 
length, such as: 

!left part!center part!! 

or 

!!center part! right part! 

in which case the left or right part of the page is unavailable for 
placement of text (i.e., the space is not redistributed to the other two 
portions). If the redistribution of the available page width is not 
desired, the placement of a single blank into a portion such as 
"!<SP>!Center Part!<SP>!" prevents the redistribution from taking 
place because each portion has a length greater than zero. (Default 
value for STR is "", meaning there is no page footer provided by default.) 

-page_header_value STR, -phv STR 

STR is the page header placed at the top of each page. Refer to the 
description of -page_footer_value for the content of a header. (Default 
-val u e for S ^is-^,- meaning th e re is no page - header provided bydefault.) 

-page__length N, -pi N 

N is the length of each formatted page given as number of lines . N can be 
given as "0" or any positive integer. "0" means the report is not to be 
paginated and is created as one continuous stream. (Default value for N 
is 66.) 

-page__width N, -pw N 

N is the width of each formatted page given as the number of character 
positions . N can be given as "0" or any positive integer . "0" means the 
page_width is always set by linus to be the exact width needed to contain 
all of the columns specified in the query. If N is greater than zero and 
the width for any column exceeds N, the width of the column is 
automatically set to N. (Default value for N is 79.) 

-row_footer_value STR, -rfv STR 

STR is the row footer placed after each detail line. Refer to the 
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description of -page_footer_valus (above) for the content of a footer. 
(Default value for STR is "", meaning that no row footer is provided.) 

-row_header_value STR, -rhv STR 

STR is the row header placed before each detail line. Refer to the 
description of -page_footer_value (above) for the content of a header. 
(Default value for STR is "", meaning that no row header is provided.) 

-separator column__id STR, -sep coluran__id STR 

STR separates a column from the next one following it and column_id (see 
" No tes") specifies v/h i c h col um n the separator applies to» Th e last 
column on a line does not have a separator. STR can be any sequence of 
printable characters. (Default value for STR is "<SP><SP>".) 

-subcount subcount__spec , -set subcount__spec 

subcount_spec determines what columns subcounts to generate, when they 
should be generated, and what type of subcount is generated. (Default 
value for subcount_spec is "", meaning that no subcounts are generated 
for any columns.) 

subcount__spec can consist of one or more blank-separated "triplets." 
The syntax of a triplet is: 

column_1 ,column_2 {reset ! running} 

where : 

column_l 

is the name or number of the column for which a subcount is 
generated. 

column_2 

is the name or number of a column whose value is examined to 
determine when to generate the subcount. When the value of the 
column being examined changes, the subcount is generated. If 
this column is a member of the group of rows defined via the 
"group" option, it, and all columns more major in the group, are 
examined for subcount generation, 

reset I running 

indicates the type of subcount desired. If reset is selected, the 
subcount counter is reset to 0 each time a subcount is generated. 
If running is selected, the subcount is not reset to 0. If a 
subcount is requested on a column that is excluded, the subcount 
is also excluded from the page. An exception to this rule is when 
all columns are excluded. Subcounts are provided in this case to 
allow reports consisting of some combination of counts, 
subcounts, totals, and subtotals only. (Default is "reset.") 

-subtotal subtotal_spec , -stt subtotal_spec 

subtotal_spec determines what column subtotals to generate, when they 
should be generated, and what type of subtotal is generated. (Default 
value for subtotal__spec is "", meaning no subtotals are generated for any 
columns . ) 

subtotal__spec can consist of one or more blank-separated triplets. The 
syntax of a triplet is: 

column__1 ,column_2 {, reset I running} 

where : 

column_1 

is the name or number of the column for which a subtotal is 
generated . 
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column 2 



is the name or number of a column whose value is examined to 
determine when to generate the subtotal. When the value of the 
column being examined changes, the subtotal is generated. If this 
column is a member of the group of rows defined via the "group" 
option , i t , and all columns more major in the group , are examined for 
subtotal generation. 

reset I running 

indicates the type of subtotal desired. If reset is selected, the 
subtotal counter is reset to 0 each time a subtotal is generated. If 
running is selected, the subtotal is not reset to 0. If a subtotal 
is requested on a column that is excluded, the subtotal is also 
excluded from the page. An exception to this rule is when all 
columns are excluded . Subtotals are provided in this case to allow 
reports consisting of some combination of counts, subcounts, 
totals, and subtotals only. (Default is "reset.") 

-title column_id STR, -ttl column_id STR 

STR is the title placed above the column at the start of each page if the 
title_line option is set "on" and column_id (see "Notes") specifies which 
column the title applies to. (Default value of STR is the name of the 
column taken from the open model or submodel . In the case of expressions , 
the default value for STR is "eN", where N begins at 1 and is incremented 
by 1 for each additional expression found in the select list. If the 
title is not the same number of characters as the display width of the 
column , the title is centered within the display width for its associated 
column. If the value of title is wider than the display width of the 
column, it is filled or truncated to obtain a correct fit, depending on 
the folding action of the parent column.) 

-title__line STR, -tl STR 

STR determines if a title line is to be printed . STR can be set to "off" to 
inhibit the printing of the title line. (Default value of STR is "on," 
meaning a title line is printed at the top of each page.) 

-total column_list, -tt column_list 

column_list determines what column totals to generate. (Default value 
for column_list is "", meaning no totals are generated for any columns . ) 

column_list can be set to a list of column names or numbers. Totals are 
generated after the last detail line. If a total is requested on a column 
that is excluded, the total is also excluded from the page. An exception 
to this rule is when all columns are excluded. Totals are provided in 
this case to allow reports consisting of some combination of counts, 
subcounts, totals, and subtotals only. 

-truncation STR, -tc STR 

STR determines the character (s) to be used to indicate truncation of some 
value. STR can be set to any sequence of printable characters . (Default 
value for STR is ».) 

-width column_id N, -wid column_id N 

N determines the display width for a column and column_id (see "Notes") 
specifies which column the width applies to. N can be set to any positive 
integer. (Default value for N is the number of character positions 
needed to contain the value, after conversion from the data type found in 
the data base, to character format.) 



2. 



control args 



can be chosen from the following: 
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-brief, -bf 

specifies that the prompt string for values is not to be displayed. If 
the -brief and -long control arguments are both entered on the request 
line, the last one supplied is used. 

-default 

specifies that linus set the value of the format option which immediately 
precedes this control argument to the system supplied default. 

-long, -Ig 

displays "Enter FORMATJ)PTION_NAME" prompt string for values when the 
-prompt control argument is provided. (Default) If the -brief and -long 
control arguments are both entered in the request line, the last one 
supplied is used. 

-no_reset, -nrs 

specifies that formatting options are not to be reset to system default 
values. (Default -- only user-specified options can be changed . ) If the 
-reset and -no_reset control argument are both entered in the request 
line, the last one supplied is used. 

-prompt 

specifies that linus prompts for the value of the format option which 
immediately precedes this control argument. A prompt string is written 
before the prompting action unless the -brief control argument is used. 
A line consisting of the single character terminates the prompted 

input mode. 

-resets, -rs 

specifies that all formatting options are to be reset to system default 
values before the values are changed for any other format options 
specified in the request line. If -reset and -no_reset are both entered 
in the request line, the last one supplied is used. 

-string STR, -str STR 

enters STR as a format option value when STR begins with a hyphen. 



Notes 



The variable column_id identifies the column name as defined in the open 
model/submodel, the number of the column in the query, or a star name which is used to 
match column names. If more than one table name is used in a select statement, the 
column_name is fully qualified (e.g., "table_name.coluran_name" , or 
"row_designator ,column__name") , otherwise the table name is unqualified (e.g., 
"table_name") . 

At least one format option argument or the -reset control argument must be 
specified. Format option arguments and control arguments can be mixed freely in. the 
request line, but a control argument cannot be placed between a format option name and 
a format option value. For example: 

set__format__options -page_width 80 -reset 

is a valid request, but 

set_format_options -page__width -reset 80 

is not valid. If a value is to be set that begins with a hyphen, the -string control 
argument must be given before the value, to distinguish it from control argnments and 
format option arguments. 
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Example 



3et_format_options -width 1 25 

set_fonnat_options -title emp_name "Employee Name" 

set_foraiat_options -reset -page_width 80 -page_length 60 

set_for!nat_options -page_footer_value "! !-[display_builtins page_nuraber]- ! ! " 

set_format_options -page_header_value -prompt 
Enter page_header_value . 

! [execute date] !LINUS REPORT! [execute time]! 
! ! ! ! 
. .inl 0 

!! — Page [ display_buil tins page_number] — !! 



set_format_options -exclude exchange extension -width area_code 12 

set forinat_options -editing area_code "[ format_line "a/'a-^a [ column_value area_code!' 
Tcoluran value exchange] [column_value extension]]" 



Request: set__mode, sm 

This request sets or resets the specified mode and changes the prompt strings. 



Usage 



sm { mode 1 . . .modeN} 
where mode^ may be one of the following: 
iteration 

turns on request line iteration processing, 
'^iteration 

turns off request line iteration processing. (Default) 
prompt 

turns on prompting. (Default) 

''prompt 

turns off prompting. 

set_linus_prompt_string STR, slups STR 

sets the linus prompt string to STR. If there are embedded blanks in STR, 
then STR must be enclosed in quotes. (Default is "linus:") 

set_lila_prompt_string STR, slaps STR 

sets the lila prompt string to STR. If there are embedded blanks in STR, 
then STR must be enclosed in quotes. (Default is "->") 
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set node 



set scope 



Mote 



The maximum prompt string length is 32 characters. 



Example 



Turn off prompting mode. 

linus: set__mode "prompt 



Request: set__scope, ss 



This request allows the user to define the current scope of access to the data 
base for nonexclusive opening modes. This request and the del_scope request are the 
means through which the user defines requirements to the linus concurrent access 
control mechanism. Every table that the user wishes to access for a given period must 
be included within the user's scope of access for that same period. As an active 
request, it returns "true" if the scope was set and "false" if the scope was not set. 



For every table to be included in the current scope, the user specifies the types 
of access required , and also those types of access which are to be prohibited to other 
users . The scope ofaccess is a dynamic entity, and may be varied to reflect theuser's 
changing requirements during the life of a linus session. In order to prevent 
deadlock situations the current scope must be set to null with the del_scope request 
prior to issuing a set__scope request. 



Usage 



ss table_namej_ permit__ops2 prevent_ops2 table_namer) permit_opsji 

prevent__opsri} {-control_arg} 



Usage as an Active Request 



[ss table__name2 premit_ops2 prevent__ops2 {... table_namen permit__opsn 
prevent__ops_} {-control__arg} ] 

where: 

1. table_namej^ 

is the name of a nontemporary table within the data base that is to be 
included in the current scope of access. 

2. permit_opsi^ 

is a character string indicating which types of data base operations are 
to be permitted the user who is setting scope for the corresponding table. 
The character string is the concatenation of the codes for all operations 
to be periuitted. See "Notes" for a description of the operation codes. 

3. prevent_opsJ. 

is a character string similar to that for permit_opsj. indicating which 
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set scope 



set_scope 



types of data base operations are to be denied other users for the 
corresponding table. 

4. control_arg 

may be either -time seconds, or -tm seconds where seconds is an integer 
that specifies the wait time in seconds to be allowed for the requested 
scope to be granted. The default wait time is 30 seconds. If the 
requested scope cannot be granted within the specified wait time, the 
user is notified of the denial and may try again or may take other 
appropriate action. 



Notes 

Codes for operation types to be permitted or prevented are: 



Code 


Operation 


d 


delete 


m 


modify 


n 


null 


r 


retrieve 


s 


store 


u 


update (store, modify, delete) 



It is recommended that users declare the minimum access scope necessary for any 
given operation and that the scope be maintained for only as long as it is needed. 
Declaration of unnecessarily large scopes is discouraged, as other users may be 
needlessly locked out of the data base. 



The set_scope request is denied if the user currently has a nonnull scope in 
force. Therefore, all of the user's access scope must be deleted with a del_scope 
request prior to issuing a set_scop8. The 3et_3cope request must then specify the 
entire scope of access required by the user for a block of operations. This is in 
contrast to the del_scope request , where portions of the current scope may be deleted . 
If another user has a conflicting scope in force, the set_scope request is denied. 

Specification of a modify, store, or delete permit_op causes a retrieve 
permit_op for the same table to be automatically requested. 

The null (n) scope operation code is ignored, unless given by itself. 



Example 



Jim Jones , the manager of the shoe department , has retired and is being replaced 
by Al Smith. Update the employee table to reflect these changes , while ensuring that 
no other users access inconsistent data. This may be done in two steps. 

Step One: Do the necessary retrieves 

1 in us : in put_quer y 
Query: 

select emp_no from emp 
where name = "Al Smith" 



linus: set_scope emp r n 
linus: assign_values !smith_no 
linus: qedx 
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set scope 



store 



2s/Al Smith/Jim Jones/ 
1,$ P 

select ernp__no from erap 
where name = "Jim Jones" 
write 
quit 

linus: assign_values !jones_no 

Step Two: Modify and delete 

linus: qedx 
1 s/emp__no/mgr/ 

2s/ name = "Jim Jones" /mgr = !jones_no 
1,$P 

select mgr from emp 
where mgr = !jones__no 
write 
quit 

linus: del_scope * 

linus: set_scope erap dm rdms 

linus: modify !smith__no -brief 

linus: qedx 

1s/mgr/*/ 

2s/mgr/emp__no/ 

1,$ P 

select * from emp 

where emp_no = !jones_no 

write 

quit 

linus : delete 
linus: del_scope • 

Notice that the only time it is necessary to prevent access to other users is 
while modify and delete are being accomplished. 



Request: store, s 



This request adds new rows to a designated table in the data base. The data base 
must be open for update or exclusive__update. If open for update, the table being 
stored must be within the current access scope for the store operation . Values being 
stored may be specified in one of three ways : 1 ) directly wi thin the request line, 2) 
interactively in response to linus prompting, or 3) by placing the values in a Multics 
file and supplying the pathname as a control argument in the store request line. Using 
the first two methods, only a single row may be stored with one store request, whereas 
the third method (file input) allows the storing of multiple rows. Moreover, if the 
new row is being entered from the terminal (as opposed to file input) , the user has the 
option of verifying the values prior to their being stored into the data base. (Also 
see the store__from__data_f ile request.) 



Usage 



s table name {column values} {-control args} 
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store 



store 



where : 

1. table_name 

is the name of the table to which rows are being added. This must be the 
name of a nontemporary table. 

2. column_values 

are optional arguments and, if present, specify the column values 
comprising the new row being added. The column_values must be specif ied 
in the same order that the corresponding columns appear in the data base 
or the data submodel, whichever is applicable. Also, exactly one value 
must be specified for every column defined in the data base or data 
submodel . 

3. control_args 

can be one or more of the following: 

-brief, -bf 

specifies that verification of column_values is not to be done. If not 
present, and if the --input_file control argument is not present, linus 
displays a list of column names, together with the column_values entered 
by the user, and requests that the user verify the correctness of the 
column_values before the store operation proceeds. If the verification 
is negative, the store does not take place, and the user must reenter the 
store request. 

-column_del imiter CHAR, -cdm CHAR 

specifies that each column_value , in the file specified via -input_file, 
is separated from the next by the CHAR character. This control argument 
has meaning only if specified together with -input_file. If not present, 
each column_value is assumed to be delimited by one or more blanks. 

-input_file path, -if path 

specifies that the column_values are to be taken from the Multics file 
designated by path, path is the pathname designating a Multics file 
suitable for processing by vfile_ in the stream_input opening mode. See 
"Notes" for a detailed description of the input file. 

-row_del imiter CHAR, -rdm CHAR 

specifies that each row value is separated from the next by the CHAR 
character . If not present , each row value is assumed to be delimited by a 
newline (NL) character. 



Notes 



If column_values are not present in the request line and -input_file is not 
specified, then linus requests each coluran_value individually by name. 

If -input_file is specified, the input file may contain column_values for more 
than one row. The input for each row is terminated by a newline character or the row 
delimiter character, if specified. In all cases, coluran_values are separated by 
blanks unless another delimiter is specified via -column delimiter. 



Examples 

Add a new supplier to the supply table, 
linus: store supply Acme 10 20G 
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store 



store from data file 



supplier = Acme 
item = 10 
vol = 200 

OK? yes 

Another way of performing the operation is: 

linus: store supply -brief 

supplier? Acme 
item? 10 
vol? 200 



Request: store__from_data_f ile, sdf 

This request reads data from a file and loads it into the specified table. It may 
I be used to reload data written by the write__data__file request. 

Usage 

sdf table_name -control_args 
where : 

1. table name 



is the name of the table defined in the open model or submodel. 



can be chosen from the following: 

-column__deliraiter CHAR, -cdm CHAR 

where CHAR is a single ASCII character used to delimit the column values. 
(Default column delimiter is the tilde.) 

-input_file pathname, -if pathname 

specifies the name of the file which contains the input data. 

-row__delimiter CHAR, -rdm CHAR 

where CHAR is a single ASCII character used to delimit the row values. 
(Default row delimiter is the newline (NL) character.) 



One level of quotes is removed from each column value, if present. 



store_from_data_f ile employee -if employee_data 
store__from__data_f ile employee -if employee__data -cdm X -rdm Y 



2. 



control_args 



Note 



Examples 
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subsystem__nane 



Several rows could be added to the supply table by first creating the following file 
with a text editor: 

Acme, 10, 200, 

XYZ, 12, 150, 

J. Smith, 10, 100, 

and then entering the following request: 

linus: store_from_data_f ile supply -input_file supply_file 
-column delimiter, 



Request: string 



This request returns a single character string formed by concatenating all of the 
strings together, separated by single spaces. 



Usage 



string {STRs} 



Usage as an Active Request 



[string {STRs}] 



If no STRs are specified, a null character string is returned. If one or more 
STRs are specified, any quotes are returned as single quotes. 



Examples 



string He said, "Hi." 
He said, Hi. 

string He said, """Hi.""" 
He said, "Hi." 

string [string This is "food".] 
This is food. 



Request: subsystem__name 



This request displays the name of the subsystem. As an active request, it 
returns the name of the subsystem. 
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subsystein__name translate__query 



Usage 



subsystem__name 



Usage as an Active Request 
[subsyst em__n am e ] 



Request: subsystem__version 



This request displays the version number of the subsystem. As an active request, 
it returns the version number of the subsystem. 



Usage 



subsystem_version 



Usage as an Active Request 
[ sub sys tem_ver sion ] 



Request: translate_query, tq 

This request translates the current query and makes it available for linus data 
manipulation requests. 

Usage 

tq 

Note 

Refer to Section 1 for examples of query statements. 
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write 



Request: write, w 



This request specifies that the selected data is to be retrieved and written to a 
specified Multics file. The output file is a text file created by vfile_ in the 
streain__output mode. If the file already exists, it may optionally be extended, 
although normally it rfould be truncated. A translated or translatable query must be 
available. 



Usage 

w outfile {-control__args} 
where : 

1. outfile 

is the pathname of a Multics file into which the selected data is to be 
written. If the file does not currently exist, it is created. If the 
file currently exists, it is truncated unless -extend is also specified. 

2. control_args 

may be one or more of the following: 

-extend 

specifies that if the outfile exists, it is to be added to, rather than 
truncated. 

-column_delimiter CHAR, -cdm CHAR 

specifies that each selected value is to be delimited by the CHAR 
character in the outfile. If not present, each selected value is 
delimited by one blank. 

-row_delimiter CHAR, -rdm CHAR 

specifies that each row is to be delimited by the CHAR character in the 
outfile. If not present, each row is delimited by a newline (NL) 
character . 



Note 



The output file is a text stream file created by vfile_. Each set of selected 
values is delimited by a newline character or the row delimiter character, if 
specified. The output file is suitable for processing by a text editor, as well as 
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write 



write data file 



other Multics facilities which process ASCII text files. 



Example 

Create a text file consisting of the name and salary of ever y employee . The query 

is : 

linus: input_ query 
Query: 

select name sal 
from emp 



The text file may then be created by: 
linus: write salary_file 



Request: write__data_file, wdf 



This request retrieves the selected data and places it in an output file, in a 
format suitable for input to the store_from_data_f ile request. 



Usage 



wdf pathname { -control_args} 
where : 

1. pathname 

is the name of the file where the data is to be written. 

2. control_args 

can be chosen from the following: 

'-column_del imiter CHAR, -cdm CHAR 

where CHAR is a single ASCII character used to delimit the column values. 
(Default column delimiter is the tilde.) 

-create_columns STR, -crc STR 

STR specif ies the column positions for new columns with null values. STR 
is a blank-separated list of numbers. (See "Notes" below.) 

-extend 

specifies that if the file already exists, it should be extended rather 
than truncated. 

-row_delimiter CHAR, -rdm CHAR 

where CHAR is a single ASCII character used to delimit the row values. 
(Default row delimiter is the newline (NL) character.) 

-trUfiOate 

specifies that if the file already exists, it should be truncated. 
(Default) 
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write data file write data file 



Notes 

The -create_columns control argument aids in the restructuring of tables. The 
column positions specified are the positions in the output file where the null value is 
placed. To create two new columns as the third and fifth columns in the output file, 
the string "-create__columns 3 5" would be used . The null value is provided by placing 
two column delimiters together without any intervening characters, and the zero 
length character string is converted according to the data type of the column when the 
store from_data_f ile request processes the input file. 

Column values are examined to determine if they contain quotes, column 
del imiter s , or row del imiters . If any of these are found , the column value is requo ted 
before it is placed in the output file. The store_frora_data_f ile request removes this 
layer of quotes when processing the file. 



Examples 



write_ 


_data__ 


file 


employee_ 


data 






write_ 


_data_ 


file 


employee_ 


data 


-extend 




write_ 


_data_ 


file 


employee_ 


data 


-create_columns 1 


5 


write_ 


data_ 


file 


employee_ 


data 


-column_del imiter 


X 


write_ 


_data_ 


file 


employee_ 


data 







abel~ 1 ~1 4555. 01 ~36~m"'s"'ak~ juneau 
abell~2~1 3000. 01 ~55~f~m"'az~phoenix 



baker" 1 ~1 2000. 10~71 "'m~s"'il~springf ield 
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SECTION 6 



OBSOLETE LINUS CONTROL ARGUMENTS/ REQUESTS 



This section contains descriptions of the pre-MR10.2 linus command and 
associated requests that are obsoleted with the installation of MR10.2. The 
requests (invoke and lila) have been replaced by new requests, but will remain 
fully supported for an indefinite period. 

The invoke request has been replaced by "exec_com" and the functions of 
lila are replaced by the requests; 



apply 
qedx 



input_quer y 
print_quer y 
save query 



translate query 



(lila new) 

(lila print) 

(lila save) 

(lila proc) 



All of the above (new) requests are described in Section 4. 



6-1 



AZ49-03 



1 inus 



linus 



Name: linus 



This command invokes linus to access an MRDS data base. It provides both 
retrieval and update operations. Data to be selected is specified via lila 
requests . 



Usage 



linus {macro path} {-control args} 



where : 

1. macro_path 

is an optional argument that specifies the pathname of an ASCII 
segment from which linus is to take its initial instructions. Such 
a set of instructions is referred to as a macro. If path does not 
have a suffix of linus, then one is assumed. However, the suffix 
linus must be the last component of the name of the segment. If 
macro path is provided, linus executes the requests contained in the 
speciTied segment and then waits for the user to type further requests. 
If the -request control argument is provided, linus executes the 
specified requests and then waits for the user to type further requests. 
If both macro_path and -request are omitted, linus Waits for the 
user to type a request. A discussion of linus macros is provided 
later in this section. The usage of this argument is incompatible 
with usage of the -request control argument below. (Default — linus 
waits for instruction from user input.) 

2. control_args 

can be chosen from the following: 

-abbrev , -ab 

enables abbreviation expansion and editing of request lines. 

-arguments macro_args, -ag macro_args 

where macro_args are one or more character strings to be substituted 
for special strings in the macro segment. This control argument may 
be specified only if macro_path is provided. 

Note: This control argument must be the last control argument given. 
The others may be given in any order. 

-iteration, -it 

recognizes parentheses in the request line to indicate request line 
iteration . 

-no_abbrev, -nab 

disables abbreviation expansion and editing of request lines. (Default) 

-no__iteration , -nit 

parentheses in the request line are interpreted literally (i.e., 
they do not cause request line iteration. (Default) 

-no_prompt, -npmt 

turns off prompting of strings. This control argument can be overridden 
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linus 



later (see set_mode request). (Default is prompt.) 

-no_start up, -nsu 

specTfies that the subsystem start up exec_com is not to be executed. 

-profile path, -pf path 

specifies the pathname of the profile used for abbreviation expansion. 
A profile suffix must be the last component to path; however, the 
suffix need not be supplied in the command line. This control argument 
implies -abbrev. 

-request STR, -rq STR 

executes STR as a linus request line before entering the request 
loop. The usage of this control argument is incompatible with the 
usage of the macro_path argument. (Refer to macro_path description 
above . ) 

-set__lila_prompt_string STR, -slaps STR 

sets the prompting string used by lila to STR. If STR contains 
embedded blanks, it must be enclosed in quotes. (Default lila prompt 
is "->".) 

-set_linus prompt_string STR, -slups STR, -prompt STR 

sets Ihe prompting string used by linus to STR. If STR contains 
embedded blanks, it must be enclosed in quotes. (Default linus prompt 
is "linus:".) 

-start_up, -su 

specifies that the subsystem start_up exec com "start_up .lec" is 
executed prior to entering the request loop. The start_up is searched 
for in the user home directory, project directory, and then >site. 
(Default) 



Notes 



While most users interact with linus through a terminal, this facility is 
designed to accept input through the user_input I/O switch and to transmit output 
through the user_output I/O switch. These switches can be controlled, via the 
io_call command, to interface with other devices/files in addition to the user's 
terminal. For convenience, the linus description assumes that the user's 
input/output device is a terminal. 



By default, linus prompts the user whenever input is expected from the 
user_input I/O switch (the string "linus:" is displayed if at linus request 
level, or the symbol "->" is displayed if within the lila editor). Refer to the 
description of the set mode request for information on how to turn off prompting. 



Multics program_interrupt conditions are recognized and handled by linus. 
Thus, the user may interrupt any request and resume the linus session by invoking 
the Multics program_interrupt command. After the program_interrupt command, linus 
waits for the user to type further requests. 



There is no data base creation facility within linus. Those users who wish 
to create their own data base should refer to Section 3 for information on the 
creation of an MRDS data base. 
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LINUS Requests 



invoke, i 

executes requests in a designated linus macro segment. 

lila 

invokes the lila editor which is used to build and process lila 
expressions to select data for manipulation by subsequent linus 
requests . 

All other linus requests are listed and described in Section ^. 



Request ; invoke, i 



This request specifies that requests contained in the designated macro segment 
are to be executed. Arguments may optionally be passed to the macro. This 
feature provides the capability to invoke a pre-defined series of linus requests. 



Usage 



i path {macro args} 



where : 

1. path 

is the pathname of the ASCII segment containing the linus macro. If 
path does not have a suffix of linus, then one is assumed. However, 
the suffix linus must be the last component of the name of path 
segment . 

2. macro_args 

are character strings to be substituted for special strings in the 
macro segment. 



Note 



Upon acceptance of the invoke request, the macro segment is read and executed, 
line-by-line. Argument substitution also takes place on a line-by-line basis, 
after the line is read and prior to its execution. After all lines in the macro 
segment are processed, linus waits for the user to type further requests on the 
terminal. The macro facility is described in detail later in this section. The 
invoke request is not compatible with request line iteration. 
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1 inus 



Example 

Execute the requests contained in the segment get_salary .linus , passing the 
argument "John Smith". 

linus: i get salary "John Smith" 



Request : lila 



This request invokes the lila editor which is used to build and process 
lila expressions. This is a line editor which is very similar to a basic editor. 
A processed lila expression must be available when a print, assign values, write, 

report, create list, modify, delete, or def ine_temp_table request" is specified. 
(Refer to Section 1 for a description of the selection language and the syntax 
and semantics of lila.) 



Usage 



lila {-control args} 



where control_args can be chosen from the following: 

-build {start} {increment} 

invokes lila build mode, an automatic numbering mode, in the current 
lila text file. The value of start determines the first line number 
of the inserted text. The value of increment, when added to the 
previous line number, yields the next automatic line number. A value 
for start must be given if an increment is to be given. Both start 
and increment must be positive integers ranging from 1 to 9999- 
Build mode is exited by entering a line consisting only of a period 
(.). The default increment is 10 and the default start is the current 
last line number plus the increment. 

-new 

specifies that text from previous invocations of the lila editor are 
to be deleted. By default, previous text is made available for 
further editing and processing. 



Lila Requests 



iiic J.J.J.ei cuj.i/J.iig I c^ucoi/O ai c . 



identifies the lila editor of linus and the linus version number. 

9 

displays a list of available requests. 
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build {start} {increment} 

invokes build mode in the current lila text file. The value of 
start designates the first automatic line number. The value of increment 
designates the offset used to generate succeeding automatic line 
numbers. (See -build control argument above.) 

execute, e 

passes the rest of the request line to the Multics command processor. 

invoke path {macro_args} , i path {macro args} 

executes requests contained in tTTe linus macro segment designated by 
path after passing any specified macro_args. This request functions 
in the same fashion as the linus invoke request. 

1 ine_number 

deletes the text line specified by line_number. 

line_number text_line 

adds or replaces the line of text in the proper sequence as specified 
by line number. The line_number may have a value ranging from 0 to 
9999. 

list, Is 

displays all text lines in the current lila file. 

1 ist_requests , Ir 

displays a brief summary of available lila requests. 



new 



deletes all text from the current lila text file. 



proc 



quit, q 



processes the lila expression source text contained in the current 
lila file to produce a processed lila expression suitable for use by 
subsequent linus data manipulation requests. 

1 

terminates the current lila session, and places the user at linus 
request level. The contents of the current lila file are retained 
for possible manipulation in a subsequent lila session within the 
current linus session. 



save path, sv path 

writes the contents of the current lila file to the segment designated 
by path for use by a subsequent invoke. If not present, a suffix of 
linus is added to path. 



Example 



Build and process a lila expression to find all items sold by departments 
located on the second floor. In the following example, one line (30) is purposely 
input with a mistake which is subsequently corrected. 

linus: lila -new 
-> 10 select item 
-> 20 from sales 

-> 30 where dept = {select deppt 

-> ^0 from loc 

-> 50 where floor = 2} 



6-6 



AZ49-03 



linus 



linus 



-> Is 

0010 select item 
0020 from sales 

0030 where dept = {select deppt 

0040 from loc 

0050 where floor = 2} 

The next entry corrects a typo "deppt" shown in line 30. 

-> 30 where dept = {select dept 
-> Is 

0010 select item 
0020 from sales 

0030 where dept = {select dept 

0040 from loc 

0050 where floor = 2} 

-> proc 

-> q 
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MACRO FACILITY 



Linus provides the capability to execute a series of requests contained in 
a text segment. Such a segment is referred to as a linus macro segment. The 
name of a linus macro segment must have a suffix of linus. 

A linus macro may be invoked in one of two ways: 1) via the linus command 
line, or 2) via the linus or lila invoke requests. Invocation via the linus 
command line is: 

linus macro_path -ai^guments argj ... argri 

which is equivalent to the sequence: 

linus 

invoke macro_path arg^ • • • argji 

A linus macro segment contains a series of linus requests in the same 
format as if they were entered at the terminal. Comments may appear in a linus 
macro segment as they would in a PL/I source segment, with the exception that a 
comment must be contained within one line. Arguments to the linus macro can be 
specified in a method analogous to the specification of arguments to a Multics 
exec_com. In a linus macro, strings of the form %i% are interpreted as dummy 
arguments and are replaced by the corresponding macro_args in the invoke request 
or in the linus command line. For example, raacro_argJ_ is substituted for the 
string %^% and macro_arglO is substituted for the string %^Q%. Substitutions 
are also made within quoted strings. If a 56 is to be included in a string, %% 
must be specified. 

The following is an example of a linus macro that displays the sales volume, 
given a department name and item code: 

o dept_store retrieval /* o data base */ 

ss sales r n /* allow read only, no prevents */ 

lila -new /* specify the data */ 

10 select vol 

20 from sales 

30 where dept = & item = %2% 

proc 

q 

pr -no_header /* no need for header */ 

ds * /* clean up */ 

c 

q 

Assume this macro resides in the segment volume. linus. Then, in order to obtain 
the sales volume for item 20 in the shoe department, the user types: 

linus volume -arguments shoe 20 

and the resulting where clause reads: 

where dept = "shoe" & item = 20 
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SECTION 7 
EXEC COM FACILITY 



The capability to execute a series of requests contained in a text segment is 
provided by linus. Such a segment is referred to as a linus exec_com. The name of a 
linus exec_com must have a suffix of lec. A linus exec__com is executed by the 
sequence : 

linus 

linus: ec exec_com__path {argi ... argn} 



A linus macro segment contains a series of linus requests in the same format as 
they were entered at the terminal. It is possible to specify arguments to the linus 
exec_com. In the linus exec_com, strings of the form &1 are substi tutable arguments 
and are replaced by the corresponding exec_com arguments in the exec_com request line. 
For example, exec_com argument 1 is substituted for the string &1, and exec_com 
argument 10 is substituted for the string &10. 



An example of a linus exec_com that displays the sales volume, given a department 



name and item 


code, is: 




&version 2 






P i „ ^ ^ -CjC 




&- 


&attach 




&- 


&if &[e equal 


&n 2] 


&- 


&then 




&- 


&else &do 




&- 



&print Usage: "ec volume dept item" 
&return 

&end 

&if &[open dept__store r] &- open data base 

&then &if &[set__scope sales r n] &- allow read only, no prevents 
&then &goto continue &- scope was set 

&else close &- scope wasn't set 

&print The data base is not available. Try again later. 

&return 

&label continue 

input_query -brief -force &- specify the data 

select vol 
from sales 

where dept = "&1 " && item = &2 &- must specify 2 &&s to get 1 & 



sfo -tl off -pi 0 

display 

del_scope * 

close 

&detach 

&quit 



&- turn title line off and set page length to 0 

&- display the data 
&- delete all scope 
&- close the data base 

&- have linus read lines from terminal again 
&- and return to linus 



Assume this exec_com resides in the segment volume. lec. Then, in order to obtain 
the sales volume for item 20 in the shoe department, the user enters: 
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linus 

linus: ec volume shoe 20 
and the resulting where clause reads: 
where dept = "shoe" & item = 20 
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APPENDIX 



STATIC DATA PARAMETERS 



The following parameters were used during the generation of the LINUS system 
software. 



Default buffer size - 256 words ( linus__data_$buf f_len ) . 

Default value for the maximum number of arguments a scalar function may take 
- 20 (linus__data_$max_sclf_items) . 

Maximum depth of invoke nesting - 20 (linus_data_$max_invocs) . 

Maximum length of a linus request - 5000 characters ( linus_data_$req_buf_len ) 

Maximum number of arguments to linus - 100 (linus_data_$max_req_args) . 

Maximum number of items in a from clause - 20 (linus_data_$max_range_items) . 

Maximum number of items in a select clause - 100 (linus_data_$max_^user_items) . 

Maximum number of LINUS variables (using the assign_value request) - 20 
(linus_data_$max_lvars) . 

Maximum number of MRDS items not previously selected that may occur in an 
expression - 20 (linus_data_$max_expr_items) . 

Maximum number of set operators that may be stacked - 10 
(linus__data__$max_set_stack_size) . 

Maximum number of temporary tables - 20 (mrds__data_$max__temp_rels) . 

Maximum string size - 500000 bits ( linus__data_$lit_string_size) . 

Number of spaces between columns for the print request - 2 
( linus_data_$pr int_col_spaces) . 

Print buffer length - 5000 characters ( linus_data__$pr_buf f_len ) . 

The following parameters were used for the generation of linus_lila_tokens__, 
which are used to define the keywords of a select statement. This segment is not bound 
in with linus. 

select - linus_lila_tokens_$select 
from - linus_lila_tokens_$frora 
where - linus_lila_tokens_$where 
inter - linus_lila__tokens_$ inter 
union - linus_lila_tokens_$union 
differ - linus_lila_tokens_$dif fer 
unique - linus__lila__tokens_$unique 
dup - linus__lila_tokens_$dup 
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INDEX 



-> 



see exclamation mark 
see quotes 

> 

see prompting mode 
see dot 

see semicolon 4-2, 



abbreviations (cont.) 
s (store) 

sfo ( set__format_options) 

ss (set_scope) 

svfo ( save_format_options) 

tq ( translate_query) 

w (write) 

MRDS (Multics Relational Data Store) 
MRPG (Multics Report Program 

Generator) 
slaps ( set_lila_prompt string) 
slups ( set_linus__prompt[__string) 

abs 

see functions 



see prompting mode 



see prompting mode 

abbr ev iations 
dup (duplicate) 
LILA (LINUS LAnguage) 
LINUS TITogicaT Inquiry and Update 

System) 
linus command 
requests 

ab (abbrev) 

ap (apply) 

av (assign_values ) 

c (close) 

els ( create_list) 

civ (coluran_value) 

d (delete) 

del (declare) 

di (display) 

dib (display_builtins) 

dltt ( delete_temp_table) 

ds (del scope) 

dtt (deTine_temp__table) 

e (execute) 

ee (exec__com) 

fl (format line) 

h (help) ~ 

i (invoke) 

iq (input query) 

Idb (lisfdb) 

Ih (list_help) 

Ir ( list_requests) 

Is (list_scope) 

Isfo ( list_format__options) 

Iv (list values) 

m (modify) 

o (open) 

odb ( opened_database) 
p' (print) 
pic (picture) 
pq ( pr int_query) 

q (quit) 

q (see lila request) 
qx (qedx) 
rpt Creport) 

rsfo (restore format options) 



after 

see functions 

arithmetic expression 1-4 

assign entry 
see functions 

asterisk 1-3 



avg 

see functions 

Backus-Naur Form 1-7 

before 

see functions 

braces 1-4 

built-in functions 
see functions 

calc entry 
see functions 

ceil 

see functions 

character string constants 
see constants 

clause 
from 1 -2 
select 1-2, 1-3 

ast<^rigk 1-^ 

restric'tion'5-1 8, 5-20, 5-44 
where 1-2 

if omitted 1-9 

logical operators 1-3 

parentheses 1-3 

relational operators 1-3 
where" 1-3 

column 3-1 
names 

see names 
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column (cont.) 
values 

specify 5-44 

command processor 
invoking 5-21 

conca t 

see functions 

constants 

character string 1-3 
quotes 1-3 

count 

see functions 

data base 

access 5-2, 6-2 
add to 5-6o 

example 5-67 
closing 5-14 
create lister file 5-15 
creation 3-1, 5-3, 6-3 

example 3-1 
delete rows 5-20 
display 5-48 
display open 5-35 
example 1-2, 3-1 
modify 5-44 
open 5-46 

update example 5-65 

data submodel 5-46 

designators 
row 1-6, 1-10 

differ (set operation) 
see operations 

display data 5-48 

domain 1-3, 1-9, 3-1 

dot 5-4, 5-8 

duplicate (dup) 

see selected values 

eval uation 

order of 1-10 

union, differ, and inter 1-9 

use of braces 1-9 

use of parentheses 1-10 

exclamation mark 5-12 

exec com 

facility 7-1 

file 

Multics 

generation 5-71 
output 5-71 

generation 5-71 

floor 

see functions 

formatted report 5-15, 5-51 

from clause 
see clause 



functions 

built-in 1-9, 2-1 
arithmetic scalar 
abs 2-1 
ceil 2-2 
floor 2-3 
mod 2-5 
round 2-5 
arithmetic set 
avg 2-2 
count 2-3 
max 2-4 
min 2-4 
sum 2-6 
character string scalar 
search 2-6 
verify 2-7 
examples 

arithmetic set — avg 1-4, 1-5, 

5-16, 5-18 
arithmetic set — max 1-4 
string scalar — substr 5-16 
string scalar 
after 2-1 
before 2-2 
concat 2-3 
index 2-4 
reverse 2-5 
substr 2-6 
declared 5-17 
installation-defined 2-7 
nonstandard 2-7, 5-16 

restrictions 2-7 
scalar 2-7, 5-16, 5-17 
set 1-4, 2-7, 5-16 
assign entry 2-7 
calc entry 2-7 
sets 5-16 

identifier 

dollar sign 1-10 
hyphen 1-10 

index 

see functions 

installation-defined functions 
see functions 

inter (set operation) 
see operations 

key column 1-2, 5-18, 5-44 

LILA 

also see abbreviations 
expression 
example 5-6 

lila requests 
summary of 6-5 

line editor 
lila 6-5 

LINUS 

also see abbreviations 
session 

terminate 5-51 
variables 

using set 5-12 

linus command 5-2, 6-2 
requests 
. 5-8 
? 5-8 
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linus command (cont.) 
abbrev 5-8 
answer 5-9 
apply 5-1 1 
assign_valu9s 5-12 
close 5-1^ 
column_value 5-14 
create_list 5-15 
declare 5-16 
def ine_teinp_table 5-17 
del scope 5-19 
delete 5-20 

delete_terap table 5-21 
display 5-2T 
display builtins 5-25 
do 5-26" 
exec_com 5-28 
execute 5-29 
format line 5-30 
help 5^32 
if 5-33 

input_query 5-3^ 
invoke 6-U 
lila 6-5 
list_db 5-35 

list format options 5-37 

list~help 5^40 

1 ist_reques ts 5-41 

list_scope 5-42 

list values 5-42 

Itrira 5-43 

modify 5-44 

open 5-46 

opened_database 5-47 
picture 5-48 
print 5-48 
print query 5-50 
qedx 5-50 
quit 5-51 
report 5-51 

r estore_format_options 5-52 
rtriffl 5-53 

save_format options 5-53 
save query "5-55 
set_7ormat_options 5-55 
set_mode 5-63 
set_scope 5-64 
store 5-66 

store_from data_file 5-68 

string 5-6"9' 

subsystem_name 5-69 

subsystem_ver sion 5-70 

translate query 5-70 

write 5-7T 

write_data_file 5-72 
set_lila__prompt string 6-2 
set_linus prompT_string 5-2, 6-3 
summary oT requests 5-4, 6-3 

lister command 5-15 
formatted report 5-15 

lister file 5-15 
create 5-16 

logical operators 

e A A /~\ r\A m 9 ^ r\ v 0 

macro 6-2, 6-4 

facility 6-8 
invoke 6-8 

example 6-8 
segment 5-3 

execute 6-4 



max 

see functions 

metalanguage 
symbols 1-7 

underscore of 1-7 

min 

see functions 
mod 

see functions 
mode 

set or reset 5-63 
MRDS 

see abbreviations 
MRPG 

see abbreviations 

names 

column 1-3, 1-6 
table 1-6 
variable 5-12 

exclamation mark 5-12 

nesting 1-6 

nonstandard functions 
see functions 

null strings 5-45 

operations 
set 

differ 1-5 
inter 1-5 
union 1-5 

union, inter, and differ 1-9 
union-compatible 1-9 

operators 

arithmetic 1-3 
evaluation precedence 1-10 
logical 1-3 
relational 1-3 

order of evaluation 
see evaluation 

output file 5-71 

parameters 

static data A-1 

parentheses 1-3 

prograra_interrupt 5-3, 6-3 

prompting mode 5-63 
-> 5-3, 5-63, 6-3 

also see set_lila_prompt_string 
? 5-3, 6-3 

also see set_linus_prompt_string 

5-63 
linus: 5-63 

question mark 

see prompting mode 
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quotes 1-3 

relational operators 
see operators 

report generation 5-51 

report writer 4-1 

default report elements 4-5 
format options 4-2 

active 4-3 

general column 4-2 

general report 4-2 

requests 4-4 

specific column 4-3 

values 4-3 
full page formatting 4-10 
optional report elements 4-6 
user session 4-13 

requests 

see linus command 



r ever se 

see functions 

round 

see functions 

row 1-2, 3-1 
designators 

see designators 

scalar functions 
see functions 

scope of access 5-19, 5-42 
defining 5-64 
operation codes 5-65 

search 

see functions 

select clause 
see clause 

select- from-where block 1-2 
inner 

braces 1-4 
set functions 

see functions 

selected values 
duplicate 1-9 
unique 1-9 



selection language 1-1 
examples 1-1 

semicolon 4-23 

set functions 
see functions 

set operations 
see operations 

set_lila_prorapt_str ing 5-63, 6-2 

set_linus_prompt_string 5-63, 6-3 

substr 

see functions 

sum 

see functions 

symbols 

see metalanguage 

Syntax and Semantics of the Selection 
Language 1-7 

table 1-1, 1-6, 3-1 
names 

see names 

temporary table 5-17 

expression simplification 5-18 
restriction 5-18, 5-36 

terminology differences (LINUS/MRDS) 
3-1 

text segment 6-8 

union (set operation) 
see operations 

unique 

see selected values 

user interaction 6-3 

variable 1-6 
list 5-12 
name 

see names 

verify 

see functions 

where clause 
see clause 
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